كيف تبدأ

  1. أنشئ حساباً على الموقع.
  2. فعّل اشتراك Premium الشهري.
  3. من صفحة مفاتيح API أنشئ مفتاحاً واحفظه فوراً.
  4. أرسل المفتاح مع كل طلب إلى العنوان الأساسي أدناه.

حد الطلبات الشهري الحالي: 500. الطلبات من الموقع لا تُخصم من هذا الحد.

المصادقة

ضع المفتاح في ترويسة Authorization بصيغة Bearer، أو في ترويسة X-Api-Key. المفتاح يبدأ بـ cdlive_ ويظهر مرة واحدة فقط.

العنوان الأساسي: https://check0ver.com/Decrypter/public/api/v1

Authorization: Bearer cdlive_xxxxxxxx
X-Api-Key: cdlive_xxxxxxxx

إذا ضاع المفتاح، ألغه وأنشئ مفتاحاً جديداً. لا تشاركه علناً.

مسار الربط المعتاد

  1. اعثر على التطبيق بـ GET /search?q=…&store=us أو sa، أو POST /lookup برابط أو track_id.
  2. أنشئ الطلب بـ POST /jobs مع الإصدار المطلوب، واختياريًا التويكات وخيارات IPA.
  3. كرر GET /jobs/{id} كل بضع ثوانٍ حتى تصبح الحالة completed أو failed.
  4. عند الاكتمال استخدم download_url لتحميل ملف IPA.

المسارات

الطريقة المسار الوصف
GET/search?q=…&store=usبحث التطبيقات بالاسم في ستور معيّن (العدد من إعدادات الموقع)
POST/lookupجلب بيانات التطبيق وآخر 5 إصدارات
POST/jobsإنشاء طلب فك جديد
GET/jobsقائمة الطلبات. يمكن ?source=api أو ?limit=30
GET/jobs/{id}حالة طلب واحد ورابط التحميل عند الجاهزية
GET/accountالاشتراك والاستهلاك الشهري
GET/tweaksأسماء التويكات الجاهزة للاستخدام في tweaks

أمثلة

بحث التطبيقات بالاسم

curl "https://check0ver.com/Decrypter/public/api/v1/search?q=whatsapp&store=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

البحث عن تطبيق

curl -X POST "https://check0ver.com/Decrypter/public/api/v1/lookup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_id":"310633997","store":"us"}'

إنشاء طلب فك

curl -X POST "https://check0ver.com/Decrypter/public/api/v1/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://apps.apple.com/us/app/id310633997","store":"us","version":"25.1.80","tweaks":[],"ipa_options":{"fix_extensions":true}}'

حالة الطلب

curl "https://check0ver.com/Decrypter/public/api/v1/jobs/123" \
  -H "Authorization: Bearer YOUR_API_KEY"

الحساب والاستهلاك

curl "https://check0ver.com/Decrypter/public/api/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY"

شكل الرد عند إنشاء الطلب

{
  "ok": true,
  "job": {
    "id": 123,
    "status": "queued",
    "progress": 0,
    "message": "Job queued",
    "app_name": "WhatsApp",
    "bundle_id": "net.whatsapp.WhatsApp",
    "version": "25.1.80",
    "store": "us",
    "download_url": null,
    "error": null
  }
}

حقول إنشاء الطلب

الحقل الوصف
q / termنص البحث (حرفان على الأقل) — GET /search
url / track_idرابط App Store أو track_id (أحدهما مطلوب)
storeus أو sa. إن وُجد رمز الدولة في الرابط يُعتمد منه
versionرقم الإصدار. إن تُرك فارغاً يُستخدم أحدث إصدار
version_indexرقم الإصدار من نتيجة lookup إن لم تُرسل version
tweaksمصفوفة slugs أو أسماء ملفات من GET /tweaks
ipa_optionsكائن خيارات IPA. إن لم يُرسل تُستخدم القيم الافتراضية

مفاتيح ipa_options: fix_extensions و remove_plugins و remove_extensions و min_os_enabled و min_os_version و document_browser.

لغة الردود: ?lang=ar أو en أو ترويسة X-Lang. الافتراضي للـ API هو الإنجليزية.

التويكات المخصصة (رفع ملفات) عبر الموقع فقط. من API استخدم slugs جاهزة من GET /tweaks.

حالات الطلب

الحالة الوصف
queuedفي الطابور بانتظار الـ Worker
preparing / processingجاري التحميل أو الفك أو الرفع
completedاكتمل. download_url جاهز
failedفشل. راجع حقل error

كرر GET /jobs/{id} حتى تصبح الحالة completed ثم استخدم download_url.

الأخطاء

كل خطأ يعود بصيغة JSON فيها ok=false و code و error.

{
  "ok": false,
  "code": "unauthorized",
  "error": "Invalid API key."
}
الرمز HTTP الوصف
unauthorized401مفتاح API غير صالح.
subscription_required403يلزم اشتراك Premium نشط لاستخدام API.
monthly_limit429وصلت لحد طلبات API هذا الشهر.
queue_full429طابور الطلبات ممتلئ. انتظر انتهاء طلب حالي.
bad_url422رابط App Store غير صالح.
app_not_found404تعذر العثور على التطبيق في هذا الستور.
version_gone422هذا الإصدار غير متاح ضمن آخر 5 نسخ.