Organisation
Tokens und Berechtigungen
Geben Sie jedem Token nur die Berechtigungen, die es braucht; ein Endpoint ohne passende Berechtigung liefert 403.
Beim Erstellen eines Tokens wählen Sie eine oder mehrere Berechtigungen (Scopes). Lesende Berechtigungen allein können Ihr Guthaben nicht antasten: Kostenpflichtige Vorgänge erfordern eine eigene Berechtigung (orders:write), Änderungen an Einstellungen eine weitere (proxies:write).
Berechtigungen
| Berechtigung | Name | Beschreibung |
|---|---|---|
orders:read | Dienstinformationen | Verbleibende Tage, verbrauchter Traffic, Anfrage- und Fehlerzahlen; Katalog, Bestand und Preisangebot. |
proxies:read | Proxy-Liste | Proxy-Adressen und Anmeldedaten. Da diese Berechtigung Zugriff auf Anmeldedaten gibt, vergeben Sie sie mit Bedacht. |
logs:read | Logs | Anfrage-Logs. Zusätzlich muss Ihre Stufe Log-Zugriff umfassen. |
orders:write | Bestellen | Gibt neue Proxy-Bestellungen auf und BUCHT DEN BETRAG VON IHREM GUTHABEN AB. Nur an Integrationen vergeben, die tatsächlich einkaufen sollen. |
proxies:write | Proxy-Einstellungen | Ändert die Einstellungen bestehender Dienste, etwa Dienstname und Traffic-Limit. Kostet kein Geld. |
Welche Berechtigung welche Endpoints freigibt
orders:read
- GET
/meToken- und Organisationsinformationen - GET
/catalogKatalog - GET
/locationsStandorte - GET
/target-urlsZiel-Domains - GET
/stockBestandsprüfung - GET
/pricingPreisangebot - GET
/ordersDienste auflisten - GET
/orders/{id}Dienstdetails - GET
/orders/{id}/usage-historyNutzungsverlauf
proxies:read
- GET
/orders/{id}/accessZugriffslisten - GET
/orders/{id}/connectionZugangsinformationen - GET
/orders/{id}/proxiesProxy-Liste
logs:read
orders:write
- POST
/ordersBestellung aufgeben - POST
/orders/{id}/renewDienst verlängern - PUT
/orders/{id}/auto-renewAutomatische Verlängerung
proxies:write
Empfohlene Kombinationen
| Integration | Berechtigungen |
|---|---|
| Nutzung und Laufzeit überwachen | orders:read |
| Proxy-Liste an Kunden weitergeben | orders:read, proxies:read |
| Log-Analyse | orders:read, logs:read |
| Automatischer Kauf und automatische Verlängerung | orders:read, orders:write, proxies:read |
| Name und Traffic-Limit automatisieren | orders:read, proxies:write |
Werden Benutzername und Passwort bei der Bestellung automatisch erzeugt, muss das Token zusätzlich proxies:read haben, damit sie in der Antwort zurückkommen.