Endpoints API

Explora todos los endpoints disponibles y sus parámetros.

URL base

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

POST

/v1/palm/analyze

Analizar una imagen de palma y detectar las líneas del corazón, cabeza y vida.

Encabezados de solicitud

Encabezado	Requerido	Description
`X-API-Key`	Sí	Su clave API de Traceline
`Content-Type`	Sí	Debe ser application/json

Cuerpo de solicitud

{
  "image": "<base64-encoded-image>"
}

image (requerido) — Imagen JPEG o PNG codificada en Base64. Tamaño máximo: 5MB.

Ejemplo de solicitud

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>"}'

Respuesta

Las respuestas exitosas devuelven un objeto JSON con los resultados del análisis.

{
  "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 respuesta

id — Identificador único de solicitud
object — Siempre "palm.analysis"
created — Marca de tiempo Unix de la solicitud
model — Versión del modelo utilizado
results.overlay — JPEG Base64 con líneas detectadas
results.masks — Máscaras PNG individuales por línea
results.stats — Estadísticas de detección por línea
usage — Información del plan y cuota actual

Encabezados de respuesta

X-Monthly-Quota-Limit — Su cuota mensual total
X-Monthly-Quota-Remaining — Solicitudes restantes este mes

GET

/v1/palm/health

Verificar si el servicio API está funcionando. Sin autenticación.

Ejemplo de solicitud

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

Respuesta

{
  "status": "ok"
}