Endpoint API

Jelajahi semua endpoint dan parameternya.

URL Dasar

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

POST

/v1/palm/analyze

Analisis gambar telapak tangan dan deteksi garis hati, kepala, dan kehidupan.

Header Permintaan

Header	Wajib	Description
`X-API-Key`	Ya	API key Traceline Anda
`Content-Type`	Ya	Harus application/json

Body Permintaan

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

image (wajib) — Gambar JPEG atau PNG enkode Base64. Ukuran maksimum: 5MB.

Contoh Permintaan

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

Respons

Respons sukses mengembalikan objek JSON dengan hasil analisis.

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

Field Respons

id — Pengenal permintaan unik
object — Selalu "palm.analysis"
created — Unix timestamp permintaan
model — Versi model yang digunakan
results.overlay — JPEG Base64 dengan garis terdeteksi
results.masks — Mask PNG terpisah untuk setiap garis
results.stats — Statistik deteksi per garis
usage — Info paket dan kuota saat ini

Header Respons

X-Monthly-Quota-Limit — Total kuota bulanan Anda
X-Monthly-Quota-Remaining — Permintaan tersisa bulan ini

GET

/v1/palm/health

Periksa apakah layanan API berjalan. Tidak perlu autentikasi.

Contoh Permintaan

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

Respons

{
  "status": "ok"
}