Autenticação

Cada solicitação ao Curriculo API leva sua chave da Console do Desenvolvedor como token de portador:

Authorization: Bearer key_<id>_<secret>

curl -X POST https://api.curriculo.me/public/detect-language/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"text": "Ingeniera de software con diez años de experiencia"}'

Uma chave, todas as operações

Uma chave da Console funciona para todas as operações no momento em que é criada. Não há credenciais por endpoint, não há escopos e não há solicitação por capacidade. Não há ATS login, não há cookie de sessão e não há cabeçalho de organização envolvido.

Obtendo API chaves

Entre na Console do Desenvolvedor e abra API chaves.

• Cada chave pode ter um nome e um vencimento opcional. Uma chave sem vencimento funciona até que você a revogue.
• O valor em texto puro é retornado uma vez, na criação. Apenas um prefixo de 16 caracteres e um SHA-256 hash são armazenados, então uma chave perdida é substituída, nunca recuperada.
• A revogação é imediata. O próximo pedido com uma chave revogada obtém 401.
• Uma conta pode ter até 25 chaves ativas.

O que uma chave precisa para servir tráfego

Uma chave é aceita quando sua conta:

• terminou de provisionar (isso acontece na primeira conexão);
• tem um saldo de crédito pré-pago acima de zero (novas contas começam com um crédito de $5.00 grátis);
• não está suspensa.

Higiene de chaves

Trate uma chave API como uma senha. Nunca a comite no controle de fontes ou cole em um cliente não confiável, e revogue-a assim que ela for exposta.

• Emita chaves separadas por ambiente ou equipe para manter o uso atribuível e cada chave revogável de forma independente.
• As chaves são limitadas à sua organização e não veem nada mais.
• Uma chave não pode gerenciar a conta. Ela não pode criar chaves ou alterar a cobrança, então uma chave vazada nunca pode escalar para controle de conta.

Erros de autenticação

Veja Erros para a lista completa.