GET /api/credits
Retorna o saldo atual de créditos para reconhecimento por foto do usuário autenticado.
Autenticação
Este endpoint utiliza autenticação por sessão (cookie). Não requer scope específico de API key.
Inclua o header Authorization: Bearer <api-key> ou use cookie de sessão.
Requisição
GET /api/credits
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | sim | Bearer pk_... (API key) ou cookie de sessão |
Exemplo
curl "https://api.placaflow.com.br/api/credits" \
-H "Authorization: Bearer pk_a1b2c3d4e5f6g7h8i9j0..."
Resposta 200
{
"credits": 1500
}
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
credits | number | Saldo atual de créditos disponíveis |
Info
Cada chamada a POST /api/recognize consome 1 crédito. Se o saldo for 0, chamadas ao /api/recognize retornam HTTP 402 (Payment Required). Créditos não expiram e são acumulativos.
Erros
| Código | Descrição |
|---|---|
| 401 | Não autenticado ou sessão expirada |