Referensi
Error
Setiap error memiliki kode tetap, status HTTP, dan flag yang menunjukkan apakah mencoba lagi bisa membantu. Cabangkan berdasarkan error_code dan retryable, bukan teks pesan.
Bentuk error
Permintaan yang gagal mengembalikan objek JSON dengan status HTTP error tersebut. Teks error adalah kalimat bahasa Inggris tetap yang diisi nilai bertipe; tidak pernah berisi teks dari sistem lain.
{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}Kolom error
errorstring- Pesan bahasa Inggris tetap untuk manusia. Skrip lama yang hanya membaca
errortetap berfungsi. error_codestring- Kode error dari daftar di bawah. Aman untuk dijadikan percabangan.
retryablebooleantruebila mengirim permintaan yang sama lagi nanti bisa berhasil.detailsobject- Nilai yang diisikan ke pesan, menurut nama, seperti
param,rule,natautime. Hanya ada bila ada nilainya. retry_afterinteger- Detik yang harus ditunggu sebelum mencoba lagi. Ada bila waktu tunggu diketahui, dan dicerminkan di header
Retry-After.
Status HTTP
Ini adalah status yang dipakai API. Frasa alasan HTTP adalah nama protokol dan tetap dalam bahasa Inggris.
- 400
Bad Request
Permintaan tidak valid. Perbaiki sebelum mengirim lagi.
- 401
Unauthorized
Kunci API tidak valid.
- 402
Payment Required
Saldo dompet terlalu rendah.
- 403
403
Akun tidak dapat menggunakan API saat ini.
- 404
Not Found
Layanan, order, isi ulang, atau webhook tidak ditemukan.
- 405
405
Hanya POST yang diterima.
- 409
Conflict
Permintaan bertentangan dengan status layanan, order, atau ID permintaan sebelumnya.
- 410
410
Layanan telah dihentikan.
- 413
413
Body permintaan terlalu besar.
- 429
Too Many Requests
Batas rate tercapai. Tunggu, lalu coba lagi.
- 500
500
Gangguan di pihak kami. Mengulang permintaan aman.
- 503
503
API atau pemesanan dijeda sebentar. Tunggu sesuai Retry-After.
Mencoba ulang dengan aman
Bila retryable bernilai true, tunggu retry_after atau header Retry-After dan tambahkan sedikit jitter acak, lalu kirim permintaan lagi. Bila bernilai false, ubah dulu permintaannya. Jika panggilan add timeout atau gagal dengan INTERNAL_ERROR, kirim lagi dengan request_id yang sama (hingga 128 karakter): Anda mendapat order asli kembali, tidak pernah order kedua.
Contoh
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"
}
}Semua kode error
Pesan adalah templat tetap; placeholder-nya diisi dari details. Setiap kode menampilkan status HTTP-nya dan apakah mencoba ulang bisa membantu.
Permintaan dan akun
- 401
INVALID_KEY
Invalid API keyKunci hilang, salah, atau dicabut. Perbaiki dulu permintaannya.
- 405
METHOD_NOT_ALLOWED
Use POSTPermintaan bukan POST. Perbaiki dulu permintaannya.
- 413
BODY_TOO_LARGE
Request body too largeBody permintaan terlalu besar. Perbaiki dulu permintaannya.
- 400
INVALID_ACTION
Invalid actionAksi bukan salah satu aksi yang terdokumentasi. Perbaiki dulu permintaannya.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Parameter wajib hilang. details.param menyebutkannya. Perbaiki dulu permintaannya.
- 400
INVALID_PARAMETER
Invalid {param}: {rule}Sebuah parameter memiliki nilai tidak valid. details.param dan details.rule menyebutkan yang mana dan mengapa. Perbaiki dulu permintaannya.
- 400
TOO_MANY_IDS
Maximum 100 IDs per requestSebuah daftar berisi lebih banyak ID daripada yang bisa dibawa satu permintaan. Perbaiki dulu permintaannya.
- 403
INACTIVE_ACCOUNT
Account suspendedAkun ditangguhkan. Perbaiki dulu permintaannya.
- 403
EMAIL_UNVERIFIED
Email verification requiredAlamat email akun belum diverifikasi. Perbaiki dulu permintaannya.
Ketersediaan dan batas
- 503
API_DISABLED
The API is temporarily disabledAPI dimatikan sebentar. Retry-After menyebutkan kapan mencoba lagi. Mencoba ulang bisa membantu.
- 429
API_RATE_LIMITED
Rate limit exceededBatas rate tercapai. Lihat Rate limit. Mencoba ulang bisa membantu.
- 500
INTERNAL_ERROR
Internal server errorSesuatu gagal di pihak kami. Mengulang add dengan request_id yang sama aman. Mencoba ulang bisa membantu.
Layanan dan pembuatan order
- 404
SERVICE_NOT_FOUND
Service not foundTidak ada layanan dengan ID ini, atau tidak tersedia untuk Anda. Perbaiki dulu permintaannya.
- 410
SERVICE_DISCONTINUED
Service has been discontinuedLayanan telah dihentikan. Perbaiki dulu permintaannya.
- 409
SERVICE_PAUSED
Service is temporarily unavailableLayanan dijeda untuk sementara. Coba lagi nanti. Mencoba ulang bisa membantu.
- 503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily pausedPemesanan dijeda untuk semua orang sebentar. Retry-After menyebutkan kapan mencoba lagi. Mencoba ulang bisa membantu.
- 400
INVALID_LINK
Link is invalid for this serviceLink tidak cocok dengan layanan ini. Perbaiki dulu permintaannya.
- 400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.Link diblokir. Hubungi dukungan bila menurut Anda itu keliru. Perbaiki dulu permintaannya.
- 409
LINK_BUSY
An order for this link is still running. Wait until it finishes.Order sebelumnya untuk link ini masih berjalan. Tunggu sampai selesai. Mencoba ulang bisa membantu.
- 400
MINIMUM_QUANTITY
Minimum quantity is {n}Jumlah di bawah minimum layanan. Perbaiki dulu permintaannya.
- 400
MAXIMUM_QUANTITY
Maximum quantity is {n}Jumlah di atas maksimum layanan. Perbaiki dulu permintaannya.
- 400
QUANTITY_STEP
Quantity must be a multiple of {step}Jumlah bukan kelipatan step layanan. Perbaiki dulu permintaannya.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})Jumlah tidak cocok dengan banyaknya item dalam daftar atau kolom reaksi. Perbaiki dulu permintaannya.
- 400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}Nilai order kurang dari jumlah order minimum. Perbaiki dulu permintaannya.
- 402
INSUFFICIENT_BALANCE
Insufficient balanceSaldo dompet lebih rendah dari biaya. Perbaiki dulu permintaannya.
- 400
INVALID_OPTION
Invalid {param}: {rule}Sebuah kolom tambahan memiliki nilai tidak valid. details.param dan details.rule menyebutkan yang mana dan mengapa. Perbaiki dulu permintaannya.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}Layanan tidak menerima kolom yang Anda kirim. Perbaiki dulu permintaannya.
- 400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this serviceLayanan tidak memiliki drip feed, atau tidak untuk jumlah ini. Perbaiki dulu permintaannya.
- 400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not bothKedua bentuk drip feed dikirim dalam satu permintaan. Perbaiki dulu permintaannya.
- 400
DRIP_FEED_INVALID
{rule}Nilai drip feed tidak sesuai batas. Pesan menyebutkan batas yang mana. Perbaiki dulu permintaannya.
- 429
ORDER_LIMIT_REACHED
Too many orders. Try again later.Terlalu banyak order dibuat atau terbuka sekaligus. Coba lagi nanti. Mencoba ulang bisa membantu.
- 409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.Pengaturan layanan berubah saat order dibuat. Kirim permintaan lagi. Mencoba ulang bisa membantu.
- 409
REQUEST_ID_CONFLICT
request_id was already used with different parametersrequest_id ini sudah membuat order dengan parameter berbeda. Perbaiki dulu permintaannya.
Order dan pembatalan
- 404
ORDER_NOT_FOUND
Order not foundTidak ada order dengan nomor ini di akun Anda. Perbaiki dulu permintaannya.
- 409
ORDER_FINISHED
Order is already {status}Order sudah selesai. Perbaiki dulu permintaannya.
- 409
CANCEL_NOT_AVAILABLE
Cancel is not available for this orderPembatalan tidak mungkin untuk order ini. Perbaiki dulu permintaannya.
- 409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.Permintaan pembatalan ditolak. Anda bisa bertanya lagi setelah waktu di details.time. Mencoba ulang bisa membantu.
Isi ulang
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderIsi ulang tidak mungkin untuk order ini. Perbaiki dulu permintaannya.
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedIsi ulang bisa dilakukan setelah order selesai. Mencoba ulang bisa membantu.
- 409
REFILL_COOLDOWN
You can request a refill again after {time}Isi ulang untuk order ini diminta belum lama ini. Coba lagi setelah details.time. Mencoba ulang bisa membantu.
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderIsi ulang untuk order ini sudah sedang berjalan. Mencoba ulang bisa membantu.
- 404
REFILL_NOT_FOUND
Refill not foundTidak ada isi ulang dengan ID ini yang milik akun Anda. Perbaiki dulu permintaannya.
Webhook
- 409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per accountAkun sudah memiliki jumlah maksimum endpoint webhook. Perbaiki dulu permintaannya.
- 404
WEBHOOK_NOT_FOUND
Webhook not foundTidak ada endpoint webhook dengan ID ini di akun Anda. Perbaiki dulu permintaannya.
- 400
INVALID_WEBHOOK_URL
Invalid webhook URLURL bukan alamat https publik. Perbaiki dulu permintaannya.