Primeiros passos

Cinco minutos, dois comandos.

1. Comece no mock

O mock não exige credencial. Use valores de exemplo em api_key e secret.

A credencial real vale para produção. Para pedir a credencial, escreva para a 77Sol e informe:

Nome da empresa e CNPJ.

O que sua integração faz, em uma frase.

Os IPs de saída do seu servidor.

Veja as regras da credencial em Autenticação.

2. Troque a credencial por um token

Guarde o access_token da resposta.

3. Faça a primeira chamada

Cote um financiamento. É a rota de negócio do contrato:

4. Conheça o envelope de erro

Uma integração pronta trata erro. O mock não valida token e responde 200 mesmo com token
inválido. O 401 real acontece só em produção. A falha volta neste envelope:

{
  "status": "error",
  "message": "..."
}

Trate esse envelope no seu código. No 422, o campo status pode faltar.
Leia Erros antes de seguir.

5. Leia o header de limite

Os headers de limite existem só em produção. O mock não envia nenhum header x-ratelimit-*.
Na primeira chamada real, leia x-ratelimit-remaining e registre o valor no seu log.
Ele avisa que você está perto do limite antes de você receber 429.

Próximo passo

Autenticação — regras do token e cuidado com o secret

Ambientes — o que o mock faz e o que só existe em produção

1. Comece no mock#

2. Troque a credencial por um token#

3. Faça a primeira chamada#

4. Conheça o envelope de erro#