Revendas
Registrar um domínio
Registra um domínio para a revenda e devolve o CNAME que o cliente precisa criar para provar controle. Só um chamador de plataforma registra domínios. Aceita Idempotency-Key (opcional).
Autorização
bearer dealer-domains:writeAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: dealer-domains:write
Parâmetros de caminho
dealer_id*integer
Id da revenda
Formato
int64Parâmetros de cabeçalho
Idempotency-Key?|
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
Registro de um domínio.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/dealers/0/domains" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "hostname": "string" }'{ "certificate_expires_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "domain_type": "string", "expected_cname": "string", "hostname": "string", "id": 0, "last_error": "string", "state": "string", "updated_at": "2019-08-24T14:15:22Z"}