المصادقة | Lahjty API

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

مصادقة Bearer

أرسل مفتاح الشريك في ترويسة Authorization من خادم موثوق. يظهر المفتاح مرة واحدة ويُخزّن كتجزئة أحادية الاتجاه ويمكن إلغاؤه.

.env

# Server environment only — never prefix this with NEXT_PUBLIC_
LAHJTY_API_KEY=lhj_live_replace_with_your_key

الترويسات المطلوبة

Authorization: Bearer lhj_live_... — جميع النقاط الخاصة
Content-Type: application/json — جميع طلبات POST
Idempotency-Key — جميع طلبات POST المدفوعة

الصلاحيات

copy:write

النصوص والعناوين

campaigns:write

الحملات المتكاملة

images:write

الصور وصور الحملات

speech:write

الصوت وصوت الحملات

templates:write

مسودات واتساب ونتائجها

usage:read

الاستخدام والطلبات المخزنة

ad-library:read

البحث في مكتبة الإعلانات وتفاصيلها

ad-library:write

تحضير الإعلانات ورفع المراجع

GET/capabilities

اختبر الاتصال دون تكلفة

نقطة الإمكانيات عامة ولا تحتاج مفتاحاً، وهي مناسبة لفحص عنوان الخدمة والقيم الحية.

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,
    "whatsapp_template": 2,
    "image": 5,
    "image_2k": 8,
    "image_edit": 5,
    "image_edit_2k": 8,
    "speech": 5
  }
}