Visão geral/OpenAPI/A autenticação

A autenticação

Configurar e verificar sua chave API com segurança.

Título: API Key

Cada ponto final do OpenAPI do KPainter, exceto GET/Health, usa a chave API do usuário:

Authorization: Bearer <your_api_key>

Ativar e copiar uma chave do API Página chave.

Verifique a conexão primeiro

curl -s "https://api.kpainter.ai/openapi/v1/me" \  -H "Authorization: Bearer $KPAINTER_API_KEY"

Uma resposta bem-sucedida devolve uma conta segura e um resumo do plano. Verifique isso antes de criar conteúdo.

Armazenamento de chaves com segurança

  • Mantenha cada chave em uma loja secreta do lado do servidor ou conexão de agente confiável.
  • Nunca coloque uma chave no código do navegador, em um pacote móvel, numa captura de tela ou em logs.
  • Não use uma chave compartilhada para usuários finais não relacionados.
  • Nunca eco a chave completa em uma mensagem de erro.
  • Peça ao usuário que se conecte novamente após uma redefinição de chave.

Respostas comuns

  • 401: a chave está ausente, invalida ou inativa.
  • 403: a conta não pode usar a capacidade solicitada.
  • 422: uma combinação de campo ou parâmetros é inexistente.
  • 429: As solicitações são muito frequentes; siga a orientação de resposta antes de se aposentar.
  • Balanço insuficiente: a criação relata um estado interrompido, créditos estimados e uma ação disponível. Não faça duplicado.

Ativação, reinstalação e eliminação de chaves da API permanecem no site da KPainter; a OpenAPI não gerencia chaves.