واجهة المطورين

واجهة REST بسيطة بصيغة JSON عبر HTTPS. تعمل مع كل لغات البرمجة. العنوان الأساسي: https://themeharvest.com/api/v1 · الحد: 60 طلبًا في الدقيقة لكل IP (طلبات الترخيص: 30).

الكتالوج (بدون مفتاح)

GET /items	العناصر المنشورة. المعاملات: q وcategory (slug) وauthor (username) وsort=sales وper_page (1–50) وpage.
GET /items/{id}	عنصر واحد مع السعر والتقييم والمبيعات والإصدار والوسوم والعرض والتوافق.
GET /categories	كل التصنيفات: id وparent_id وmarket وname وslug.

curl "https://themeharvest.com/api/v1/items?sort=sales&per_page=5"

المؤلفون: التحقق من رمز الشراء

أنشئ رمزك الشخصي في Studio ← API ورموز الشراء وأرسله كرمز Bearer. تظهر مبيعات عناصرك فقط.

GET /author/purchase/verify?code=…	هل رمز الشراء هذا حقيقي؟ العنصر والمشتري والترخيص وتاريخ الدعم والاسترداد.
GET /author/sales	آخر مبيعاتك (50 في الصفحة) ورصيدك.
GET /author/items	كل عناصرك مع حالتها.

curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \
  "https://themeharvest.com/api/v1/author/purchase/verify?code=PURCHASE-CODE"

تفعيل الترخيص (داخل عنصرك)

يستدعيها عنصرك من خادم المشتري. لا حاجة لرمز: رمز الشراء + رقم العنصر هما الإثبات. الحقول: code وitem_id وdomain (نموذج أو JSON).

POST /license/activate	عند التثبيت. 200 {"active":true} · 404 not_found · 409 limit_reached · 403 refunded
GET /license/check	مرة يوميًا — هل ما زال صالحًا؟
POST /license/deactivate	عند الإزالة — يحرّر النطاق.

curl -X POST https://themeharvest.com/api/v1/license/activate -d code=PURCHASE-CODE -d item_id=ITEM_ID -d domain=example.com

المؤلفون: كود جاهز لـ PHP وWordPress وNode.js وPython وJava وC# وGo وFlutter برقم عنصرك موجود في Studio ← عناصري ← 🔑 License & API.

تحديثات تلقائية

GET /updates/check?item_id=…&code=…&version=1.0.0	أحدث إصدار وسجل التغييرات ورابط تنزيل صالح 30 دقيقة (يتطلب شراءً فعّالًا).
GET /updates/{id}/info	معلومات الإصدار العامة لعنصر.

الأخطاء

401	الرمز مفقود أو خاطئ
404	غير موجود (رمز أو عنصر خاطئ أو رمز لعنصر آخر)
422	حقل مفقود أو غير صالح
429	طلبات كثيرة — انتظر دقيقة

كل الردود بصيغة JSON. أرسل "Accept: application/json".