Unterkonten

Ein Sub-Account ist eine Kennzeichnung, die Sie Ihrem Proxy-Benutzernamen hinzufügen, damit der damit gesendete Traffic separat gezählt wird. Verwenden Sie einen pro Kunde, Projekt oder Team, um zu sehen, wer was genutzt hat, ohne separate Pläne oder Zugangsdaten.

Sub-Accounts sind in Residential-Proxy-Plänen verfügbar.

Einen Sub-Account verwenden

Fügen Sie -subaccount-NAME direkt nach Ihrem Benutzernamen hinzu. Targeting- und Session-Optionen folgen wie gewohnt danach:

customer-USERNAME-subaccount-client_a-country-us-sid-abc123-ttl-600:PASSWORD@p.shifter.io:443

curl -x customer-USERNAME-subaccount-client_a:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json

Öffnen Sie im Panel einen Residential-Plan und gehen Sie zu Sub-accounts: Geben Sie einen Namen ein, und es wird der vollständige Benutzername und die Proxy-Zeile angezeigt, bereit zum Kopieren. Der Proxy Generator auf derselben Seite verfügt ebenfalls über ein Sub-account-Feld zum Erstellen von Endpunkten mit Targeting und Sessions.

Regel	Detail
Zeichen	1 bis 16 Buchstaben, Ziffern oder Unterstriche (A-Z, a-z, 0-9, _). Keine Bindestriche: Der Bindestrich trennt die Optionen des Benutzernamens
Groß-/Kleinschreibung	Groß-/Kleinschreibung wird unterschieden: Client_A und client_a sind zwei Sub-Accounts
Geltungsbereich	Pro Plan: Derselbe Name auf zwei Plänen ergibt zwei separate Sub-Accounts
Erstellung	Keine notwendig. Ein Sub-Account erscheint einige Minuten nach seiner ersten Anfrage
Aufbewahrung	Wird bis 365 Tage nach seiner letzten Anfrage aufgeführt. Ein innerhalb dieses Zeitraums wiederverwendeter Name führt seine alte Historie fort

Achtung

Sub-Accounts dienen nur der Nachverfolgung. Sie nutzen das Passwort und die Bandbreite Ihres Plans, und es werden keine Limits pro Sub-Account durchgesetzt: Wenn Sie den Zugang weiterverkaufen, wenden Sie Limits und Abrechnung auf Ihrer eigenen Plattform anhand der untenstehenden Werte an. Der Traffic eines Sub-Accounts ist keine Abrechnungsgröße; maßgeblich ist die Nutzung Ihres Plans.

Im Panel listet die Plan-Seite jeden Sub-Account mit seinem Traffic für heute, die letzten 7 Tage und die letzten 30 Tage auf, und das Traffic-Diagramm auf der Plan-Seite und im Dashboard kann zwischen dem Hauptaccount und jedem Sub-Account wechseln.

Authentifizierung

Beide Endpunkte erwarten den api_token Ihres Accounts als Query-Parameter, genau wie bei der Usage & Quota API. Erzeugen Sie ihn im Panel unter Account → API Tokens. Jeder ist auf 30 Anfragen pro Minute begrenzt.

Der Pfadparameter {membership} akzeptiert die auf der Plan-Seite angezeigte Membership ID (zum Beispiel 68057) oder den kurzen Code aus der URL des Plans (zum Beispiel Rxqk).

Sub-Accounts auflisten

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts

Gibt jeden Sub-Account zurück, der in den letzten 365 Tagen im Plan aufgetreten ist, sortiert nach Namen.

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Membership ID oder Kurzcode
api_token	query	ja	Ihr Account-API-Token

Beispiel:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts?api_token=YOUR_API_TOKEN"

Antwort:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccounts": ["BigReseller_7", "client_a", "client_b"]
  }
}

Ein Plan, der noch nie Sub-Account-Traffic gesendet hat, gibt eine leere Liste zurück.

Sub-Account-Nutzung über einen Zeitraum

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts/{subaccount}/usage

Der von einem Sub-Account zwischen zwei Zeitpunkten genutzte Traffic.

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Membership ID oder Kurzcode
subaccount	path	ja	Sub-Account-Name, exakte Schreibweise
api_token	query	ja	Ihr Account-API-Token
start	query	ja	Beginn des Zeitfensters, einschließlich
end	query	ja	Ende des Zeitfensters, ausschließlich

start und end akzeptieren ein Datum (2026-10-01) oder einen vollständigen Zeitstempel (2026-10-01T09:00:00), höchstens 366 Tage auseinander. Die Zeiten werden nach Pariser Zeit ausgelesen, der Uhrzeit, nach der die Traffic-Zähler laufen.

Beispiel:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts/client_a/usage?start=2026-10-01&end=2026-11-01&api_token=YOUR_API_TOKEN"

Antwort:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccount": "client_a",
    "start": "2026-10-01T00:00:00",
    "end": "2026-11-01T00:00:00",
    "granularity": "day",
    "bytes": 412380000000,
    "gb": 412.38,
    "upload_bytes": 18230000000,
    "download_bytes": 394150000000,
    "requests": 9184402
  }
}

Granularität

Der Traffic wird in Buckets gezählt, und jeder Bucket, den das Zeitfenster berührt, wird vollständig gezählt:

• Zeitfenster, die innerhalb der letzten 7 Tage beginnen, verwenden stündliche Buckets ("granularity": "hour").
• Ältere Zeitfenster verwenden tägliche Buckets ("granularity": "day"), sodass ein Zeitfenster ab 2026-09-01T15:00:00 den gesamten 1. September zählt.

Für exakte Tageswerte verwenden Sie ganze Tage als Zeitfenster.

Ein Sub-Account ohne Traffic im Zeitfenster oder ein abgelaufener Sub-Account liefert Nullwerte zurück.

Fehler

Status	Bedeutung
400	Der Plan ist kein Residential-Proxy-Plan, der Sub-Account-Name ist ungültig, oder start/end fehlen, sind in falscher Reihenfolge oder liegen mehr als 366 Tage auseinander
401	Fehlender oder ungültiger api_token
403	Der Plan befindet sich in einem Workspace, dem Sie nicht angehören
404	Plan nicht gefunden
429	Rate-Limit erreicht, erneut versuchen mit Backoff
503	Sub-Account-Daten sind vorübergehend nicht verfügbar, erneut versuchen mit Backoff