DOM360
Financeiro

Gravar o SMTP próprio da revenda

PUT
/billing/dealer-settings/{dealer_id}/smtp

Grava o servidor da revenda. Os campos ausentes ficam como estão (ou no padrão, na primeira gravação: porta 587, TLS ligado, SMTP ligado). A senha é obrigatória na primeira gravação e só de escrita; é guardada cifrada, e sem chave de cifragem na plataforma a gravação é recusada (503).

Autorização

bearer billing:write
Autorizaçã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: billing:write

Parâmetros de caminho

dealer_id*integer

Id da revenda

Formatoint64

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

O corpo de PUT /billing/dealer-settings/{dealer_id}/smtp. Os campos ausentes ficam como estão (ou no padrão, na primeira gravação); a senha é obrigatória só na primeira e é só de escrita.

Corpo da resposta

application/json

application/json

curl -X PUT "https://example.com/billing/dealer-settings/0/smtp" \  -H "Content-Type: application/json" \  -d '{    "host": "string",    "username": "string"  }'
{  "enabled": true,  "has_password": true,  "host": "string",  "last_test_at": "2019-08-24T14:15:22Z",  "last_test_error": "string",  "port": 0,  "use_ssl": true,  "use_tls": true,  "username": "string"}