Criar autorização

POST/v1/margem/autorizacao

🔒 Requer Bearer token

Escopo margem:read. Cria (ou reusa) a autorização de consentimento e retorna o link que o parceiro entrega ao trabalhador. A Socinal não envia nada — o nome (exibido na página) e o telefone (para o parceiro mandar o link por WhatsApp) ficam registrados na autorização.

Corpo da requisição

cpfstringobrigatório

CPF do trabalhador (11 dígitos)

padrão: ^\d{11}$

nomestringobrigatório

Nome do trabalhador — exibido na página de autorização

mín. 2 car.

telefonestringobrigatório

Telefone do trabalhador com DDD (10 ou 11 dígitos)

mín. 10 car. · máx. 11 car.

Respostas

200Autorização criada (ou reusada); `link` para o trabalhador.

400Dados inválidos (`ERRO_VALIDACAO`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

Request

curl -X POST 'http://localhost:3101/v1/margem/autorizacao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf": "12345678901",
  "nome": "Maria da Silva",
  "telefone": "11999998888"
}'

Response

{
  "link": "http://localhost:3100/autorizar/a1b2c3d4e5f6a7b8c9d0e1f2",
  "expira_em": "2026-06-14T02:59:59.999Z",
  "status": "pendente"
}