Unterkonten (Unterbenutzer)
Aktualisiert:
Stellen Sie Unterbenutzer-Pakete bereit und verwalten Sie deren Listen – ohne Ihre Hauptzugangsdaten weiterzugeben.
A subuser-Paket ist ein Unterabonnement, das aus Ihrem Haupt-Privatkundenpaket ausgegliedert wurde. Sie weisen ihm einen Teil des Datenvolumens und eine Gültigkeitsdauer zu, und der Unternutzer verwaltet darin seine eigenen Listen.
Verwenden Sie dies für Wiederverkäufer, Teammitglieder oder isolierte Client-Umgebungen. Der im Unterpaket verbrauchte Datenverkehr wird von Ihrem Hauptkontingent abgezogen; bei Löschung fließt der nicht genutzte Datenverkehr an das übergeordnete Kontingent zurück.
Subuser-Paket
Unterpakete erstellen, konfigurieren und entfernen
Lesen
Schreiben
Listen im „subuser“-Paket
gleiche Vorgänge wie bei übergeordneten Wohnortlisten, jedoch auf ein Unterpaket beschränkt
Lesen
Schreiben
Besonderes: API-TOOL-Liste
Gilt für alle Endpunkte von Unterkonten
Basis-URL
https://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/Authentifizierung
API-Schlüssel im URL-Pfad (dein Hauptkontoschlüssel, nicht der des Unterbenutzers)
Erforderlicher Parameter
Die meisten Endpunkte erfordern einen „package_key“ – diesen erhalten Sie unter
GET/de-DE/residentsubuser/packagesFehlermodell
Geschäftliche Fehler führen zu einem HTTP-Status 200 mit ausgefüllten Fehlerfeldern[]
Verwandte Themen
Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpenFAQ
Nein – die Bezeichnung ist irreführend. In dieser API ist ein „Subuser“ ein Unterpaket: ein Teil Ihres Haupt-Wohnpakets mit eigenem traffic_limit, expired_at, is_active Umschaltelemente und Listen.
Alle /residentsubuser/... Endpunkte nehmen {YourApiKey} — Ihre eigenen. In der Spezifikation wird an keiner Stelle ein zweiter API-Schlüssel vergeben. Die Zugangsdaten, die Ihr Endnutzer erhält, sind auf Listenebene login/password (zurückgegeben von /residentsubuser/list/add) – das sind Verbindungsdaten für den Proxy, keine Verwaltungsschlüssel.
Nein. Der Unterbenutzer sieht nur seine eigenen traffic_limit und consumed. Das Hauptkonto sieht beide Ebenen.
Aufruf update-package mit einer erhöhten traffic_limit. Die Aufladung wird sofort wirksam.
Nein. Listen sind an das Unterpaket gebunden, in dem sie erstellt wurden. Erstellen Sie die Liste unter dem Ziel-Unterbenutzer neu.