Ambientes

Cada chave de API pertence a um ambiente, codificado no prefixo da chave.

Ambiente	Prefixo	Uso
`live`	`no_live_`	Produção — opera sobre dados reais.
`test`	`no_test_`	Testes e homologação.

observação

Os dados de test e live são isolados. Use sempre chaves test durante o desenvolvimento da integração.

URLs base

Ambiente	URL base
Produção	`https://api.nearone.com.br/api/integrations/v1`
Staging	`https://api-staging.nearone.com.br/api/integrations/v1`

Use chaves test contra o ambiente de staging durante o desenvolvimento; chaves live operam sobre dados reais em produção.

Idempotência

Requisições de escrita (POST/PUT) aceitam o cabeçalho Idempotency-Key. Reenviar a mesma chave com o mesmo payload retorna o resultado original sem reexecutar a operação; a mesma chave com payload diferente retorna 400.

curl -X POST https://api.nearone.com.br/api/integrations/v1/companies \
  -H "Authorization: Bearer no_test_xxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 5f3c1a8e-..." \
  -H "Content-Type: application/json" \
  -d '{ "cnpj": "00000000000191", "name": "Empresa Exemplo" }'

URLs base​

Idempotência​

URLs base

Idempotência