Alterar uma revenda
Altera parte de uma revenda. Um master altera qualquer campo; um administrador de revenda altera só o nome da própria revenda. A marca se altera em PATCH /dealers/{dealer_id}/branding (um bloco branding aqui é recusado, 422). is_active liga ou desliga a revenda. O cadastro financeiro (remetente, CNPJ, contatos) se altera em PATCH /billing/dealer-settings/{dealer_id}; um bloco billing aqui é recusado (422). Devolve a revenda atualizada.
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 caminho
Id da revenda
int64Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
Alteração parcial de uma revenda. Campo ausente fica como está; nenhum
campo aceita null (422).
Um master altera qualquer campo. Um administrador de revenda só altera o
name da própria revenda — o serviço recusa o resto. A marca não entra
aqui (PATCH /dealers/{dealer_id}/branding), nem o cadastro financeiro
(PATCH /billing/dealer-settings/{dealer_id}).
Corpo da resposta
application/json
application/json
curl -X PATCH "https://example.com/dealers/0" \ -H "Content-Type: application/json" \ -d '{}'{ "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"}