Autenticacao
Autenticacao
A Career API utiliza chaves API para autenticacao. As chaves sao geridas atraves da Consola Laddro.
Cabecalho da Chave API
Passe a sua chave API no cabecalho x-api-key em cada pedido protegido:
curl https://api.laddro.com/v1/resumes \
-H "x-api-key: lk_live_abc123..."Endpoints Publicos vs Protegidos
Alguns endpoints sao publicos e nao requerem autenticacao:
| Endpoint | Autenticacao Necessaria |
|---|---|
GET /v1/templates | Nao |
GET /v1/templates/{templateId} | Nao |
GET /v1/fonts | Nao |
GET /v1/languages | Nao |
GET /v1/models | Nao |
| Todos os outros endpoints | Sim |
Gerir Chaves API
Na Consola:
- Criar - Gere uma nova chave. Copie-a imediatamente, so e apresentada uma vez.
- Listar - Veja todas as suas chaves ativas (ultimos 4 caracteres visiveis).
- Revogar - Desative uma chave permanentemente.
- Regenerar - Substitua uma chave por uma nova.
Seguranca das Chaves
- Nunca inclua chaves API no controlo de versoes
- Utilize variaveis de ambiente nas suas aplicacoes
- Rode as chaves regularmente
- Revogue chaves imediatamente se comprometidas
Limites de Pedidos
| Tipo de Endpoint | Limite |
|---|---|
| Publico (sem autenticacao) | 30 pedidos/minuto |
| Protegido (com chave API) | 100 pedidos/minuto |
Exceder o limite devolve 429 Too Many Requests. Consulte Limites de Pedidos para custos de creditos e limites mensais.
Respostas de Erro
| Estado | Significado |
|---|---|
401 Unauthorized | Chave API em falta ou invalida |
402 Payment Required | Sem creditos restantes. Adquira mais ou aguarde a renovacao do ciclo de 30 dias |
403 Forbidden | A chave nao tem permissao para esta acao |
429 Too Many Requests | Limite de pedidos excedido |