المرجع
الأخطاء
لكل خطأ رمز ثابت وحالة HTTP وعلامة تبيّن هل تفيد إعادة المحاولة. تفرّع حسب error_code وretryable لا حسب نص الرسالة.
صيغة الخطأ
يعيد الطلب الفاشل كائن JSON مع حالة HTTP الخاصة بالخطأ. نص error جملة إنجليزية ثابتة مملوءة بقيم محددة النوع؛ ولا تحتوي أبدًا على نص من أنظمة أخرى.
{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}حقول الخطأ
errorstring- رسالة إنجليزية ثابتة للبشر. السكربتات الأقدم التي تقرأ
errorفقط تواصل العمل. error_codestring- رمز الخطأ من القائمة أدناه. آمن للتفرع عليه.
retryablebooleantrueعندما يمكن أن ينجح إرسال الطلب نفسه مرة أخرى لاحقًا.detailsobject- القيم التي مُلئت في الرسالة، بأسمائها، مثل
paramأوruleأوnأوtime. موجود فقط عند وجود أي منها. retry_afterinteger- الثواني التي يجب انتظارها قبل المحاولة مجددًا. موجود عندما تكون مدة الانتظار معروفة، ويُعكس في ترويسة
Retry-After.
حالات HTTP
هذه هي الحالات التي تستخدمها API. عبارات أسباب HTTP أسماء بروتوكول وتبقى بالإنجليزية.
- 400
Bad Request
الطلب غير صالح. صحّحه قبل إرساله مجددًا.
- 401
Unauthorized
مفتاح API غير صالح.
- 402
Payment Required
رصيد المحفظة منخفض جدًا.
- 403
403
لا يستطيع الحساب استخدام API الآن.
- 404
Not Found
لم يُعثر على الخدمة أو الطلب أو إعادة التعبئة أو الـ webhook.
- 405
405
يُقبل POST فقط.
- 409
Conflict
الطلب يتعارض مع حالة خدمة أو طلب أو معرّف طلب سابق.
- 410
410
أُوقفت الخدمة نهائيًا.
- 413
413
جسم الطلب كبير جدًا.
- 429
Too Many Requests
تم بلوغ حد المعدل. انتظر ثم أعد المحاولة.
- 500
500
عطل من جانبنا. تكرار الطلب آمن.
- 503
503
API أو تقديم الطلبات متوقف مؤقتًا لفترة قصيرة. انتظر وفق Retry-After.
إعادة المحاولة بأمان
عندما تكون قيمة retryable هي true، انتظر retry_after أو ترويسة Retry-After وأضف قدرًا عشوائيًا من التأخير، ثم أرسل الطلب مجددًا. وعندما تكون false، غيّر الطلب أولًا. إذا انتهت مهلة استدعاء add أو فشل برمز INTERNAL_ERROR، فأرسله مجددًا بالقيمة نفسها في request_id (حتى 128 حرفًا): تحصل على الطلب الأصلي، لا على طلب ثانٍ أبدًا.
أمثلة
key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10000{
"error": "Insufficient balance",
"error_code": "INSUFFICIENT_BALANCE",
"retryable": false
}key=YOUR_API_KEY&action=balance{
"error": "Rate limit exceeded",
"error_code": "API_RATE_LIMITED",
"retryable": true,
"retry_after": 12
}key=YOUR_API_KEY&action=add&link=https://instagram.com/example&quantity=100{
"error": "Missing required parameter: service",
"error_code": "MISSING_PARAMETER",
"retryable": false,
"details": {
"param": "service"
}
}كل رموز الأخطاء
الرسالة هي القالب الثابت؛ وتُملأ عناصره النائبة من details. يعرض كل رمز حالة HTTP الخاصة به وهل تفيد إعادة المحاولة.
الطلب والحساب
- 401
INVALID_KEY
Invalid API keyالمفتاح مفقود أو خاطئ أو ملغى. صحّح الطلب أولًا.
- 405
METHOD_NOT_ALLOWED
Use POSTلم يكن الطلب من نوع POST. صحّح الطلب أولًا.
- 413
BODY_TOO_LARGE
Request body too largeجسم الطلب كبير جدًا. صحّح الطلب أولًا.
- 400
INVALID_ACTION
Invalid actionالإجراء ليس من الإجراءات الموثقة. صحّح الطلب أولًا.
- 400
MISSING_PARAMETER
Missing required parameter: {param}معامل مطلوب مفقود. يسمّيه details.param. صحّح الطلب أولًا.
- 400
INVALID_PARAMETER
Invalid {param}: {rule}قيمة معامل غير صالحة. يبيّن details.param و details.rule أيّها ولماذا. صحّح الطلب أولًا.
- 400
TOO_MANY_IDS
Maximum 100 IDs per requestتحتوي قائمة على معرّفات أكثر مما يستطيع طلب واحد حمله. صحّح الطلب أولًا.
- 403
INACTIVE_ACCOUNT
Account suspendedالحساب موقوف. صحّح الطلب أولًا.
- 403
EMAIL_UNVERIFIED
Email verification requiredالبريد الإلكتروني للحساب لم يُوثَّق بعد. صحّح الطلب أولًا.
التوفر والحدود
- 503
API_DISABLED
The API is temporarily disabledAPI متوقفة مؤقتًا لفترة قصيرة. يبيّن Retry-After متى تعيد المحاولة. قد تفيد إعادة المحاولة.
- 429
API_RATE_LIMITED
Rate limit exceededتم بلوغ حد المعدل. انظر حدود المعدل. قد تفيد إعادة المحاولة.
- 500
INTERNAL_ERROR
Internal server errorحدث عطل من جانبنا. تكرار add بالقيمة نفسها في request_id آمن. قد تفيد إعادة المحاولة.
الخدمات وتقديم الطلبات
- 404
SERVICE_NOT_FOUND
Service not foundلا توجد خدمة بهذا المعرّف، أو أنها غير متاحة لك. صحّح الطلب أولًا.
- 410
SERVICE_DISCONTINUED
Service has been discontinuedأُوقفت الخدمة نهائيًا. صحّح الطلب أولًا.
- 409
SERVICE_PAUSED
Service is temporarily unavailableالخدمة متوقفة مؤقتًا حاليًا. حاول لاحقًا. قد تفيد إعادة المحاولة.
- 503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily pausedتقديم الطلبات متوقف للجميع لفترة قصيرة. يبيّن Retry-After متى تعيد المحاولة. قد تفيد إعادة المحاولة.
- 400
INVALID_LINK
Link is invalid for this serviceالرابط لا يناسب هذه الخدمة. صحّح الطلب أولًا.
- 400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.الرابط محظور. تواصل مع الدعم إذا رأيت أن ذلك خطأ. صحّح الطلب أولًا.
- 409
LINK_BUSY
An order for this link is still running. Wait until it finishes.ما زال طلب سابق لهذا الرابط قيد التنفيذ. انتظر حتى ينتهي. قد تفيد إعادة المحاولة.
- 400
MINIMUM_QUANTITY
Minimum quantity is {n}الكمية أقل من الحد الأدنى للخدمة. صحّح الطلب أولًا.
- 400
MAXIMUM_QUANTITY
Maximum quantity is {n}الكمية أكبر من الحد الأقصى للخدمة. صحّح الطلب أولًا.
- 400
QUANTITY_STEP
Quantity must be a multiple of {step}الكمية ليست من مضاعفات خطوة الخدمة. صحّح الطلب أولًا.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})الكمية لا تطابق عدد العناصر في قائمة أو في حقل التفاعلات. صحّح الطلب أولًا.
- 400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}قيمة الطلب أقل من الحد الأدنى لمبلغ الطلب. صحّح الطلب أولًا.
- 402
INSUFFICIENT_BALANCE
Insufficient balanceرصيد المحفظة أقل من المبلغ المطلوب خصمه. صحّح الطلب أولًا.
- 400
INVALID_OPTION
Invalid {param}: {rule}قيمة حقل إضافي غير صالحة. يبيّن details.param و details.rule أيّها ولماذا. صحّح الطلب أولًا.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}الخدمة لا تقبل حقلًا أرسلته. صحّح الطلب أولًا.
- 400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this serviceليس للخدمة تغذية تدريجية، أو ليس لهذه الكمية. صحّح الطلب أولًا.
- 400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not bothأُرسلت صيغتا التغذية التدريجية معًا في طلب واحد. صحّح الطلب أولًا.
- 400
DRIP_FEED_INVALID
{rule}قيم التغذية التدريجية لا تناسب الحدود. تبيّن الرسالة أي حد. صحّح الطلب أولًا.
- 429
ORDER_LIMIT_REACHED
Too many orders. Try again later.قُدّم عدد كبير جدًا من الطلبات أو هي مفتوحة في الوقت نفسه. حاول لاحقًا. قد تفيد إعادة المحاولة.
- 409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.تغيّرت إعدادات الخدمة أثناء تقديم الطلب. أرسل الطلب مجددًا. قد تفيد إعادة المحاولة.
- 409
REQUEST_ID_CONFLICT
request_id was already used with different parametersهذا request_id أنشأ طلبًا بالفعل بمعاملات مختلفة. صحّح الطلب أولًا.
الطلبات والإلغاء
- 404
ORDER_NOT_FOUND
Order not foundلا يوجد طلب بهذا الرقم يخص حسابك. صحّح الطلب أولًا.
- 409
ORDER_FINISHED
Order is already {status}انتهى الطلب بالفعل. صحّح الطلب أولًا.
- 409
CANCEL_NOT_AVAILABLE
Cancel is not available for this orderلا يمكن إلغاء هذا الطلب. صحّح الطلب أولًا.
- 409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.رُفض طلب الإلغاء. يمكنك السؤال مجددًا بعد المدة المذكورة في details.time. قد تفيد إعادة المحاولة.
عمليات إعادة التعبئة
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderلا يمكن إعادة تعبئة هذا الطلب. صحّح الطلب أولًا.
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedيمكن إعادة التعبئة بعد اكتمال الطلب. قد تفيد إعادة المحاولة.
- 409
REFILL_COOLDOWN
You can request a refill again after {time}طُلبت إعادة تعبئة لهذا الطلب قبل وقت قصير. حاول مجددًا بعد details.time. قد تفيد إعادة المحاولة.
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderتوجد إعادة تعبئة قيد التنفيذ بالفعل لهذا الطلب. قد تفيد إعادة المحاولة.
- 404
REFILL_NOT_FOUND
Refill not foundلا توجد إعادة تعبئة بهذا المعرّف تخص حسابك. صحّح الطلب أولًا.
Webhooks
- 409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per accountلدى الحساب بالفعل الحد الأقصى من نقاط نهاية webhook. صحّح الطلب أولًا.
- 404
WEBHOOK_NOT_FOUND
Webhook not foundلا توجد نقطة نهاية webhook بهذا المعرّف في حسابك. صحّح الطلب أولًا.
- 400
INVALID_WEBHOOK_URL
Invalid webhook URLعنوان URL ليس عنوان https عامًا. صحّح الطلب أولًا.