Sous-comptes

Un sous-compte est une étiquette que vous ajoutez à votre nom d’utilisateur proxy afin que le trafic envoyé avec celui-ci soit comptabilisé séparément. Utilisez-en un par client, projet ou équipe pour voir qui a utilisé quoi, sans plans ni identifiants distincts.

Les sous-comptes sont disponibles sur les plans Residential Proxies.

Utiliser un sous-compte

Ajoutez -subaccount-NAME juste après votre nom d’utilisateur. Les options de ciblage et de session le suivent comme d’habitude :

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

Dans le panneau, ouvrez un plan Residential et allez dans Sub-accounts : saisissez un nom et il affiche le nom d’utilisateur complet et la ligne proxy, prêts à copier. Le Proxy Generator sur la même page dispose également d’un champ Sub-account pour construire des points de terminaison avec ciblage et sessions.

Règle	Détail
Caractères	1 à 16 lettres, chiffres ou tirets bas (A-Z, a-z, 0-9, _). Pas de tirets : le tiret sépare les options du nom d’utilisateur
Casse	Sensible à la casse : Client_A et client_a sont deux sous-comptes
Portée	Par plan : le même nom sur deux plans correspond à deux sous-comptes distincts
Création	Aucune nécessaire. Un sous-compte apparaît quelques minutes après sa première requête
Conservation	Listé jusqu’à 365 jours après sa dernière requête. Un nom réutilisé dans cette fenêtre conserve son ancien historique

Attention

Les sous-comptes servent uniquement au suivi. Ils utilisent le mot de passe et la bande passante de votre plan, et aucune limite n’est appliquée par sous-compte : si vous revendez l’accès, appliquez des limites et une facturation sur votre propre plateforme en utilisant les chiffres ci-dessous. Le trafic des sous-comptes n’est pas un chiffre de facturation ; l’utilisation de votre plan l’est.

Dans le panneau, la page du plan liste chaque sous-compte avec son trafic pour aujourd’hui, les 7 derniers jours et les 30 derniers jours, et le graphique de trafic sur la page du plan et le tableau de bord peut basculer entre le compte principal et n’importe quel sous-compte.

Authentification

Les deux points de terminaison prennent le api_token de votre compte comme paramètre de requête, comme pour l’API Usage & Quota. Générez-le dans le panneau sous Account → API Tokens. Chacun est limité à 30 requêtes par minute.

Le paramètre de chemin {membership} accepte le Membership ID affiché sur la page du plan (par exemple 68057) ou le code court de l’URL du plan (par exemple Rxqk).

Lister les sous-comptes

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

Renvoie tous les sous-comptes observés sur le plan au cours des 365 derniers jours, triés par nom.

Paramètre	Dans	Requis	Description
membership	path	oui	Membership ID ou code court
api_token	query	oui	Le jeton API de votre compte

Exemple :

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

Réponse :

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

Un plan qui n’a jamais envoyé de trafic de sous-compte renvoie une liste vide.

Utilisation d’un sous-compte sur une période donnée

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

Trafic utilisé par un sous-compte entre deux points dans le temps.

Paramètre	Dans	Requis	Description
membership	path	oui	Membership ID ou code court
subaccount	path	oui	Nom du sous-compte, casse exacte
api_token	query	oui	Le jeton API de votre compte
start	query	oui	Début de la fenêtre, inclusif
end	query	oui	Fin de la fenêtre, exclusif

start et end acceptent une date (2026-10-01) ou un horodatage complet (2026-10-01T09:00:00), avec un écart maximal de 366 jours. Les heures sont lues à l’heure de Paris, l’horloge sur laquelle fonctionnent les compteurs de trafic.

Exemple :

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"

Réponse :

{
  "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é

Le trafic est comptabilisé par paliers, et chaque palier touché par la fenêtre est compté entièrement :

• Les fenêtres qui commencent dans les 7 derniers jours utilisent des paliers horaires ("granularity": "hour").
• Les fenêtres plus anciennes utilisent des paliers journaliers ("granularity": "day"), ainsi une fenêtre commençant à 2026-09-01T15:00:00 comptabilise la totalité du 1er septembre.

Pour des chiffres précis par jour, utilisez des journées entières comme fenêtres.

Un sous-compte sans trafic dans la fenêtre, ou ayant expiré, renvoie des zéros.

Erreurs

Statut	Signification
400	Le plan n’est pas un plan Residential Proxies, le nom du sous-compte est invalide, ou start/end sont manquants, dans le mauvais ordre, ou séparés de plus de 366 jours
401	api_token manquant ou invalide
403	Le plan se trouve dans un espace de travail auquel vous n’appartenez pas
404	Plan introuvable
429	Limite de requêtes atteinte, réessayez avec un délai croissant
503	Les données du sous-compte sont temporairement indisponibles, réessayez avec un délai croissant