Autenticação de API

Obtendo uma Chave de API

Para obter uma chave de API, você precisa ter uma conta iloveQR e fazer parte de uma organização.

Usando sua chave de API

Inclua sua chave de API no cabeçalho X-API-Key com cada solicitação:

curl -X GET \
  https://api.iloveqr.com/api/v1/organizations/YOUR_ORG_ID/qr-codes \
  -H "X-API-Key: ilqr_your_api_key_here" \
  -H "Content-Type: application/json"

ID da Organização

A maioria dos endpoints da API requer um ID de organização no caminho da URL. Você pode encontrar seu ID de organização nas configurações do painel ou fazendo uma solicitação ao endpoint de organizações.

curl -X GET \
  https://api.iloveqr.com/api/v1/users/me/organizations \
  -H "X-API-Key: ilqr_your_api_key_here"

{
  "organizations": [
    {
      "id": "org_abc123",
      "name": "My Company",
      "slug": "my-company",
      "role": "ADMIN"
    }
  ]
}

Práticas Recomendadas de Segurança

Erros de Autenticação

Quando a autenticação falha, a API retorna uma dessas respostas de erro:

{
  "statusCode": 401,
  "message": "Invalid or missing API key",
  "error": "Unauthorized"
}