GET/api/v1/profile

Perfil

Name: Avatrix
Price: 67.00 BRL
Availability: InStock

Bearer tokenescopo read:profile

Retorna os dados do perfil do usuário associado ao Bearer token. Responde 200 OK.

Escopo necessário: read:profile (ver Escopos).

Exemplo de request

cURL

curl https://avatrix.io/api/v1/profile \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxx"

Resposta — 200

Os dados do perfil vêm dentro do envelope padrão:

JSON

{
  "success": true,
  "data": {
    "name": "Maria Silva",
    "email": "[email protected]",
    "credits": 1200,
    "bonusCredits": 50,
    "planId": "pro",
    "plan": {
      "id": "pro",
      "name": "Pro",
      "credits": 1000,
      "features": ["Geração ilimitada de imagens", "..."]
    }
  }
}

planId é "free" quando não há assinatura ativa. plan é null quando o plano correspondente não está disponível.

Erros relevantes

Código	HTTP	Quando
`UNAUTHORIZED`	401	token ausente, inválido, expirado ou revogado
`FORBIDDEN`	403	token sem `read:profile`
`NOT_FOUND`	404	usuário não encontrado
`RATE_LIMITED`	429	rate limit (60 req/min por token), com `Retry-After`

Ver Erros.