reseller

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

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

Autenticação

Envie uma chave de API como um token de portador. A chave deve ter a permissão reseller.provision; uma chave sem ela é recusada com 403, e não 404.

Onde vai o ID da sua organização

Este endpoint aceita org_id como parâmetro de consulta. Omita-o e a chamada abrangerá toda a sua subárvore de locatários; envie-o para restringir a chamada a uma única organização.

O ID da sua organização está na tela de chaves de API no seu painel, ao lado da própria chave. É o mesmo ID em todas as chamadas que você fizer.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

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

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

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.

Parâmetros

Nome	Tipo	Obrigatório	O que é
`siteId (path)`	`Uuid`	Sim	Site ID (UUIDv7).
`org_id (query)`	`Uuid`	Não	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…

Resposta

Nome	Tipo	Obrigatório	O que é
`url`	`string`	Sim	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`	Sim	—
`client_org_id`	`Uuid`	Não	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Erros que este endpoint pode retornar

401 · 403 · 404 · 409 · 429 · 503