طريقة الربط عبر API
اربط بوتك أو موقعك بمنصة فك التشفير. الاشتراك الشهري Premium يفتح المفاتيح والطلبات.
كيف تبدأ
- أنشئ حساباً على الموقع.
- فعّل اشتراك Premium الشهري.
- من صفحة مفاتيح API أنشئ مفتاحاً واحفظه فوراً.
- أرسل المفتاح مع كل طلب إلى العنوان الأساسي أدناه.
حد الطلبات الشهري الحالي: 500. الطلبات من الموقع لا تُخصم من هذا الحد.
المصادقة
ضع المفتاح في ترويسة Authorization بصيغة Bearer، أو في ترويسة X-Api-Key. المفتاح يبدأ بـ cdlive_ ويظهر مرة واحدة فقط.
العنوان الأساسي: https://check0ver.com/Decrypter/public/api/v1
Authorization: Bearer cdlive_xxxxxxxx X-Api-Key: cdlive_xxxxxxxx
إذا ضاع المفتاح، ألغه وأنشئ مفتاحاً جديداً. لا تشاركه علناً.
مسار الربط المعتاد
- اعثر على التطبيق بـ GET /search?q=…&store=us أو sa، أو POST /lookup برابط أو track_id.
- أنشئ الطلب بـ POST /jobs مع الإصدار المطلوب، واختياريًا التويكات وخيارات IPA.
- كرر GET /jobs/{id} كل بضع ثوانٍ حتى تصبح الحالة completed أو failed.
- عند الاكتمال استخدم 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 (أحدهما مطلوب) |
store | us أو 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 | الوصف |
|---|---|---|
unauthorized | 401 | مفتاح API غير صالح. |
subscription_required | 403 | يلزم اشتراك Premium نشط لاستخدام API. |
monthly_limit | 429 | وصلت لحد طلبات API هذا الشهر. |
queue_full | 429 | طابور الطلبات ممتلئ. انتظر انتهاء طلب حالي. |
bad_url | 422 | رابط App Store غير صالح. |
app_not_found | 404 | تعذر العثور على التطبيق في هذا الستور. |
version_gone | 422 | هذا الإصدار غير متاح ضمن آخر 5 نسخ. |