لهجتيلهجتي
دليل API

البدء السريع

أرسل أول طلب من الخادم وافهم غلاف الاستجابة وتحقق من التكامل بأمان.

1. تحقق من الإمكانيات

اجلب الإمكانيات أثناء التكامل وخزّنها مؤقتاً لمدة قصيرة، حتى لا تنفصل القيم أو الأسعار الثابتة القديمة عن العقد الفعلي.

GET/capabilities

Read live capabilities

This public endpoint is the source of truth for supported values, current credit costs, scopes, and rate limits.

curl --request GET \
  --url https://www.lahjty.com/api/v1/capabilities

Example response

response.json
{
  "object": "capabilities",
  "api_version": "2026-09-03",
  "output_languages": [
    "ar",
    "en"
  ],
  "dialects": [
    "saudi",
    "gulf",
    "emirati",
    "egyptian",
    "classical",
    "levantine",
    "iraqi"
  ],
  "credit_costs": {
    "copy": 2,
    "headline": 2,
    "conversion": 1,
    "image": 5,
    "speech": 5,
    "whatsapp_template": 2
  }
}

2. أنشئ نصاً

يحتاج كل طلب POST مدفوع إلى مفتاح idempotency فريد. يمكنك إعادة المفتاح والطلب نفسيهما بعد انتهاء المهلة دون خصم مرتين.

POST/copy-generations

نص واتساب سعودي

ينشئ نسخاً متعددة مع فحص العبارات المطلوبة والممنوعة.

curl --request POST \
  --url https://www.lahjty.com/api/v1/copy-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: partner-copy-merchant91-campaign1842" \
  --data '{
  "type": "ad_copy",
  "description": "Weekend offer: 20% off specialty coffee subscriptions",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "platform": "whatsapp",
  "tone": "warm",
  "framework": "aida",
  "audience": "specific",
  "specific_audience": "Young professionals in Riyadh",
  "required_keywords": [
    "قهوة مختصة"
  ],
  "excluded_keywords": [
    "مجاني"
  ],
  "call_to_action": "اطلب الآن",
  "external_customer_id": "merchant-91"
}'

Example response

response.json
{
  "id": "cpy_01jexample",
  "object": "copy_generation",
  "request_id": "req_01jexample",
  "status": "completed",
  "type": "ad_copy",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "dialect_source": "explicit",
  "variants": [
    {
      "index": 1,
      "content": "خصم 20٪ على اشتراك القهوة المختصة لنهاية الأسبوع. اطلب الآن.",
      "keyword_compliance": {
        "passed": true,
        "missing_required": [],
        "matched_excluded": []
      }
    }
  ],
  "usage": {
    "credits_used": 2,
    "balance_after": 498
  }
}

3. خزّن حقول المطابقة

  • request_id يربط السجلات وإعادة المحاولة واسترجاع الطلب وحالات الدعم.
  • external_id / external_customer_id يربطان التوليد بسجلات الحملة والتاجر لديك.
  • usage يوضح الخصم الفعلي والرصيد بعد الاكتمال.

واجهة Lahjty للشركاء

ابنِ تدفقات تسويق عربية وإنجليزية تشمل النصوص وصور الحملات والصوت العربي والحملات المتكاملة ومسودات قوالب واتساب بهيكل Meta.

المصادقة

احمِ مفاتيح الشريك واطلب الصلاحيات اللازمة فقط وأرسل الترويسات التي تتطلبها الواجهة.