Criar revenda
Cria uma revenda. Só um master cria revendas. Aceita o cadastro financeiro (billing), gravado na mesma transação. A marca não entra aqui: depois da criação, altere-a em PATCH /dealers/{dealer_id}/branding e envie os arquivos em /dealers/{dealer_id}/branding/assets/{kind}. Devolve a revenda criada. Aceita Idempotency-Key (opcional).
Autorização
bearer dealers:writeCredencial 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: dealers:write
Parâmetros de cabeçalho
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.
Criação de uma revenda. Só um master cria revendas. A marca não entra aqui:
ela se altera em PATCH /dealers/{dealer_id}/branding e nos envios de
arquivo, depois da criação.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/dealers" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "slug": "string" }'{ "branding": { "brand_version": 0, "dealer_name": "string", "favicon_url": "string", "login_title": "string", "logo_url": "string", "page_title": "string", "sidebar_logo_icon_url": "string", "sidebar_logo_url": "string", "theme": {} }, "created_at": "2019-08-24T14:15:22Z", "id": 0, "is_active": true, "name": "string", "settings": {}, "slug": "string", "updated_at": "2019-08-24T14:15:22Z"}