reseller

POST `/v1/reseller/services/{siteId}/sso`

A one-time sign-in link into the panel for this client.

Authentification

Envoyez une clé API en tant que jeton du porteur. La clé doit posséder l'autorisation reseller.provision ; une clé qui ne l'a pas est refusée avec le code 403, et non 404.

Où insérer l'ID de votre organisation

Cet point de terminaison prend org_id comme paramètre de requête. Omettez-le et l'appel couvrira l'ensemble de votre sous-arbre de location ; envoyez-le pour restreindre l'appel à une seule organisation.

L'identifiant de votre organisation se trouve sur l'écran des clés API de votre tableau de bord, à côté de la clé elle-même. Il s'agit du même identifiant pour chaque appel que vous effectuez.

Essayer

Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.

curl -X POST https://api.zinndigital.com/v1/reseller/services/{siteId}/sso \
  -H "Authorization: Bearer zdk_live_…"

Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API

Détails

Mints a single-use, short-lived URL that drops your client straight into their own account in the panel, already signed in, with no password to remember. This is what the "Log in to your hosting" button in your billing panel or on your WordPress site opens. Requires `reseller.provision`. The ticket travels in the URL **fragment**, so it is never sent to a server, never appears in a `Referer` and never reaches an access log. It is good for a few minutes and can be redeemed once. The session it opens is confined to that one client organization and is audit-logged against you, not against them.

Paramètres

Nom	Type	Obligatoire	Qu'est-ce que c'est
`siteId (path)`	`Uuid`	Oui	Site ID (UUIDv7).
`org_id (query)`	`Uuid`	Non	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r…

Réponse

Nom	Type	Obligatoire	Qu'est-ce que c'est
`url`	`string`	Oui	Open this in the client's browser. The single-use ticket is in the URL fragment, so it never reaches a server log. Redeem once, within `expires_at`.
`expires_at`	`string`	Oui	—
`client_org_id`	`Uuid`	Non	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Erreurs que cet point de terminaison peut renvoyer

401 · 403 · 404 · 409 · 429 · 503