YoozMarket-API-Keys: Bestellen aus dem eigenen Panel oder Skript
Aktualisiert:
Wenn Sie ein eigenes Panel, einen Bot oder ein Skript betreiben, können Sie YoozMarket-Bestellungen per Code statt im Dashboard aufgeben. Dieser Leitfaden zeigt, wie Keys funktionieren, welche Aktionen es gibt und was mit Ihrem Wallet passiert.
Key erstellen und sicher aufbewahren
Öffnen Sie im Dashboard den Bereich API und erstellen Sie einen Key. Geben Sie ihm einen Namen, damit Sie wissen, wo er genutzt wird; bis zu 5 aktive Keys sind möglich, nutzen Sie also pro Anwendung einen eigenen. Der Key wird nur einmal angezeigt und nur als Hash gespeichert, kopieren Sie ihn daher sofort. Haben Sie ihn verloren, widerrufen Sie ihn und erstellen Sie einen neuen.
Was Sie aufrufen können
Senden Sie JSON- (oder Formular-)Anfragen mit Ihrem Key und einer Aktion an https://yooz.market/api/v1.
- balance: Ihr Wallet-Guthaben.
- services: bestellbare Dienste mit Min/Max und Preis pro Einheit.
- add: Bestellung aufgeben mit Dienst, Link und Menge (und Reaktion, wo nötig).
- status: Status einer Bestellung anhand ihrer ID.
- getCountries: Länder mit verfügbaren virtuellen Nummern und der Preis einer Nummer.
- getNumber: Nummer per country_code kaufen; liefert die Nummer und eine order_id.
- getCode: Login-Code einer gekauften Nummer oder waiting.
Abrechnung, Wiederholungen und Erstattungen
API-Bestellungen werden zu denselben Preisen wie im Dashboard vom Wallet abgebucht, eine fehlgeschlagene Bestellung wird automatisch erstattet. Fügen Sie bei add oder getNumber einen optionalen idempotency_key hinzu, damit eine Wiederholung nie eine zweite Bestellung erzeugt. Fehler kommen mit status "error" und dem Feld message_error zurück.
Key widerrufen
Widerrufen Sie einen Key auf derselben Seite; alles, was ihn nutzt, funktioniert sofort nicht mehr. Das lässt sich nicht rückgängig machen, deshalb lohnt sich ein eigener Key pro Anwendung.