نقاط النهاية

استكشف جميع نقاط النهاية المتاحة ومعاملاتها.

عنوان URL الأساسي

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

/v1/palm/analyze

تحليل صورة الكف واكتشاف خطوط القلب والعقل والحياة.

رؤوس الطلب

الرأسمطلوبDescription
X-API-Keyنعممفتاح API الخاص بك في Traceline
Content-Typeنعميجب أن يكون application/json

متن الطلب

{
  "image": "<base64-encoded-image>"
}
  • image (مطلوب) — صورة JPEG أو PNG مشفرة بـ Base64. الحجم الأقصى: 5MB.

مثال طلب

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

الاستجابة

تعيد الاستجابات الناجحة كائن JSON مع نتائج التحليل.

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

حقول الاستجابة

  • id — معرف طلب فريد
  • object — دائمًا "palm.analysis"
  • created — طابع زمني Unix للطلب
  • model — إصدار النموذج المستخدم
  • results.overlay — JPEG مشفر بـ Base64 مع خطوط مكتشفة
  • results.masks — أقنعة PNG منفصلة لكل خط
  • results.stats — إحصائيات الاكتشاف لكل خط
  • usage — معلومات الخطة والحصة الحالية

رؤوس الاستجابة

  • X-Monthly-Quota-Limit — إجمالي حصتك الشهرية
  • X-Monthly-Quota-Remaining — الطلبات المتبقية هذا الشهر
GET

/v1/palm/health

تحقق مما إذا كانت خدمة API تعمل. لا تحتاج مصادقة.

مثال طلب

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

الاستجابة

{
  "status": "ok"
}