Endpoints da API

Explore todos os endpoints disponíveis e seus parâmetros.

URL base

https://api.trace-line.site/v1
POST

/v1/palm/analyze

Analisar imagem da palma e detectar linhas do coração, cabeça e vida.

Cabeçalhos da requisição

CabeçalhoObrigatórioDescription
X-API-KeySimSua chave API Traceline
Content-TypeSimDeve ser application/json

Corpo da requisição

{
  "image": "<base64-encoded-image>"
}
  • image (obrigatório) — Imagem JPEG ou PNG codificada em Base64. Tamanho máximo: 5MB.

Exemplo de requisição

curl -X POST https://api.trace-line.site/v1/palm/analyze \
  -H "X-API-Key: trl_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64-encoded-image>"}'

Resposta

Respostas bem-sucedidas retornam um objeto JSON com os resultados da análise.

{
  "id": "req_abc123",
  "object": "palm.analysis",
  "created": 1700000000,
  "model": "traceline-v1",
  "results": {
    "overlay": "<base64-overlay-image>",
    "masks": {
      "heart": "<base64-mask>",
      "head": "<base64-mask>",
      "life": "<base64-mask>"
    },
    "stats": {
      "heart": {
        "pixels": 1842,
        "confidence": 0.94
      },
      "head": {
        "pixels": 1567,
        "confidence": 0.91
      },
      "life": {
        "pixels": 2103,
        "confidence": 0.96
      }
    }
  },
  "usage": {
    "requests_used": 42,
    "requests_limit": 100
  }
}

Campos de resposta

  • id — Identificador único da requisição
  • object — Sempre "palm.analysis"
  • created — Timestamp Unix da requisição
  • model — Versão do modelo utilizado
  • results.overlay — JPEG Base64 com linhas detectadas
  • results.masks — Máscaras PNG individuais por linha
  • results.stats — Estatísticas de detecção por linha
  • usage — Informações do plano e cota atual

Cabeçalhos de resposta

  • X-Monthly-Quota-Limit — Sua cota mensal total
  • X-Monthly-Quota-Remaining — Requisições restantes este mês
GET

/v1/palm/health

Verificar se o serviço API está funcionando. Sem autenticação.

Exemplo de requisição

curl https://api.trace-line.site/v1/palm/health

Resposta

{
  "status": "ok"
}