77Sol - Integração
    • Paginação e filtros
    • Webhooks
    • Limites de uso
    • Versionamento e depreciação
    • Changelog
    • Visão geral
    • Primeiros passos
    • Autenticação
    • Ambientes
    • Erros
    • Raiz
      • Autenticação
        • Emissão do token de acesso
      • Simulações
        • Cotação por valor e prazo
        • Cotação precificada por CPF
    • Esquemas
      • Erro
      • ErroDeValidacao
      • Cotacao

    Primeiros passos

    Cinco minutos, três comandos.

    1. Peça sua credencial de sandbox#

    Escreva para a 77Sol informando:
    Nome da empresa e CNPJ.
    O que sua integração faz, em uma frase.
    Os IPs de saída do seu servidor.
    Você recebe api_key e secret do sandbox.

    2. Troque a credencial por um token#

    Guarde o access_token da resposta.

    3. Faça a primeira chamada#

    Consulte um CEP. É a rota mais simples do contrato e não escreve nada:

    4. Force um erro de propósito#

    Uma integração pronta trata erro. Provoque um 401 agora, com token inválido:
    Confira que você recebe {"status": "error", "message": "..."} e trate esse envelope no seu
    código. Leia [Erros] — Erros antes de seguir.

    5. Leia o header de limite#

    Toda resposta traz x-ratelimit-remaining. Registre esse valor no seu log. Ele avisa que você
    está perto do teto antes de você receber 429.

    Próximo passo#

    [Autenticação] — Autenticação — regras do token e cuidado com o secret
    [Ambientes] — Ambientes — o que o sandbox de hoje não faz
    Modificado em 2026-09-02 14:10:22
    Página anterior
    Visão geral
    Próxima página
    Autenticação
    Built with