Autenticação
Cada solicitação carrega uma chave de API no cabeçalho Authorization padrão. As chaves pertencem a uma conta e consomem os créditos dessa conta.
Authorization: Bearer du_live_...Criar uma chave
- É necessária uma conta paga. A cunhagem é recusada com
403até que a conta tenha comprado créditos. - Abrir Perfil → Chaves de API e crie uma chave nomeada.
- A chave completa é exibida uma vez. Armazene-a em uma variável de ambiente ou em um gerenciador de segredos.
- Até 10 chaves ativas por conta. A revogação é imediata para novas solicitações; trabalhos já em execução continuam em execução.
Como uma chave é verificada
- O token de portador deve começar com
du_live_. - A chave é validada em cada solicitação.
- Uma chave ausente, malformada, desconhecida, revogada ou de conta removida retorna o mesmo
401 unauthorized. - Cada chave informa seu horário de último uso na página de perfil.
Revogar
Use o botão de revogação na página de perfil. A revogação é idempotente; uma segunda revogação da mesma chave é inofensiva. Uma chave que pertence a outra conta é reportada como não encontrada.
Mantenha do lado do servidor
A API não envia cabeçalhos CORS. Foi criada para servidores, scripts e agentes locais, não para código de navegador. Uma chave num aplicativo web ou móvel empacotado é uma chave pública.