دليل API

الاستخدام والطلبات

اقرأ الرصيد المشترك وطابق الاستخدام الأخير واستعد النتائج المخزنة بعد انتهاء مهلة العميل.

GET/usage

اقرأ الرصيد والاستخدام

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

curl --request GET \
  --url https://www.lahjty.com/api/v1/usage \
  --header "Authorization: Bearer $LAHJTY_API_KEY"

Example response

response.json
{
  "balance": 476,
  "credits_used": 24,
  "requests": [
    {
      "id": "req_01jexample",
      "operation": "campaign",
      "status": "completed",
      "credits": 12,
      "credits_refunded": 0
    }
  ]
}
GET/requests/req_01jexample

استعد طلباً بعد انتهاء المهلة

تُحفظ سجلات الطلبات النهائية ونتائجها 30 يوماً. استخدم request_id المعاد سابقاً.

curl --request GET \
  --url https://www.lahjty.com/api/v1/requests/req_01jexample \
  --header "Authorization: Bearer $LAHJTY_API_KEY"

Example response

response.json
{
  "id": "req_01jexample",
  "object": "api_request",
  "status": "completed",
  "operation": "copy",
  "credits": 2,
  "credits_charged": 2,
  "credits_refunded": 0,
  "result": {
    "id": "cpy_01jexample",
    "object": "copy_generation",
    "status": "completed"
  }
}

حقول المطابقة

  • خزّن request_id من كل استجابة ناجحة أو خطأ.
  • استخدم external_id للحملة وexternal_customer_id للتاجر.
  • اعتبر استجابة الاستخدام وحالة الاسترداد السجل المالي، لا تقديراً على العميل.