Referans
Hatalar
Her hatanın sabit bir kodu, bir HTTP durumu ve yeniden denemenin işe yarayıp yaramayacağını söyleyen bir bayrağı vardır. İleti metnine değil, error_code ve retryable üzerinden dallanın.
Hata biçimi
Başarısız bir istek, hatanın HTTP durumuyla bir JSON nesnesi döndürür. error metni, türlendirilmiş değerlerle doldurulmuş sabit bir İngilizce cümledir; diğer sistemlerden gelen metin asla içermez.
{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}Hata alanları
errorstring- İnsanlar için sabit bir İngilizce ileti. Yalnızca
errorokuyan eski betikler çalışmaya devam eder. error_codestring- Aşağıdaki listeden hata kodu. Üzerinden dallanmak güvenlidir.
retryableboolean- Aynı isteği daha sonra yeniden göndermek başarılı olabiliyorsa
true. detailsobject- İletiye doldurulan değerler, adlarıyla; örneğin
param,rule,nveyatime. Yalnızca varsa bulunur. retry_afterinteger- Yeniden denemeden önce beklenecek saniye. Bekleme süresi biliniyorsa bulunur ve
Retry-Afterbaşlığında da yansıtılır.
HTTP durumları
API'nin kullandığı durumlar bunlardır. HTTP neden ifadeleri protokol adlarıdır ve İngilizce kalır.
- 400
Bad Request
İstek geçerli değil. Tekrar göndermeden önce düzeltin.
- 401
Unauthorized
API anahtarı geçerli değil.
- 402
Payment Required
Cüzdan bakiyesi çok düşük.
- 403
403
Hesap şu anda API'yi kullanamıyor.
- 404
Not Found
Hizmet, sipariş, yenileme veya webhook bulunamadı.
- 405
405
Yalnızca POST kabul edilir.
- 409
Conflict
İstek, bir hizmetin, bir siparişin veya önceki bir istek kimliğinin durumuyla çakışıyor.
- 410
410
Hizmet kaldırıldı.
- 413
413
İstek gövdesi çok büyük.
- 429
Too Many Requests
Bir hız sınırına ulaşıldı. Bekleyin, sonra yeniden deneyin.
- 500
500
Bizim tarafımızda bir arıza. İsteği tekrarlamak güvenlidir.
- 503
503
API veya sipariş verme kısa süreliğine duraklatıldı. Retry-After kadar bekleyin.
Güvenle yeniden deneme
retryable true olduğunda retry_after veya Retry-After başlığı kadar bekleyin, biraz rastgele sapma ekleyin ve isteği yeniden gönderin. false olduğunda önce isteği değiştirin. Bir add çağrısı zaman aşımına uğrarsa veya INTERNAL_ERROR ile başarısız olursa, aynı request_id ile (en fazla 128 karakter) yeniden gönderin: özgün siparişi geri alırsınız, asla ikinci bir sipariş değil.
Örnekler
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"
}
}Tüm hata kodları
İleti sabit şablondur; yer tutucuları details içinden doldurulur. Her kod HTTP durumunu ve yeniden denemenin işe yarayıp yaramayacağını gösterir.
İstek ve hesap
- 401
INVALID_KEY
Invalid API keyAnahtar eksik, yanlış veya iptal edilmiş. Önce isteği düzeltin.
- 405
METHOD_NOT_ALLOWED
Use POSTİstek bir POST değildi. Önce isteği düzeltin.
- 413
BODY_TOO_LARGE
Request body too largeİstek gövdesi çok büyük. Önce isteği düzeltin.
- 400
INVALID_ACTION
Invalid actionİşlem, belgelenmiş işlemlerden biri değil. Önce isteği düzeltin.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Zorunlu bir parametre eksik. details.param bunu adlandırır. Önce isteği düzeltin.
- 400
INVALID_PARAMETER
Invalid {param}: {rule}Bir parametrenin değeri geçersiz. details.param ve details.rule hangisi ve neden olduğunu söyler. Önce isteği düzeltin.
- 400
TOO_MANY_IDS
Maximum 100 IDs per requestBir liste, tek bir isteğin taşıyabileceğinden fazla kimlik içeriyor. Önce isteği düzeltin.
- 403
INACTIVE_ACCOUNT
Account suspendedHesap askıya alınmış. Önce isteği düzeltin.
- 403
EMAIL_UNVERIFIED
Email verification requiredHesabın e-posta adresi henüz doğrulanmadı. Önce isteği düzeltin.
Kullanılabilirlik ve sınırlar
- 503
API_DISABLED
The API is temporarily disabledAPI kısa süreliğine kapalı. Retry-After ne zaman yeniden deneyeceğinizi söyler. Yeniden denemek işe yarayabilir.
- 429
API_RATE_LIMITED
Rate limit exceededBir hız sınırına ulaşıldı. Bkz. Hız limitleri. Yeniden denemek işe yarayabilir.
- 500
INTERNAL_ERROR
Internal server errorBizim tarafımızda bir şey başarısız oldu. Aynı request_id ile add tekrarlamak güvenlidir. Yeniden denemek işe yarayabilir.
Hizmetler ve sipariş verme
- 404
SERVICE_NOT_FOUND
Service not foundBu kimliğe sahip bir hizmet yok veya sizin için kullanılamıyor. Önce isteği düzeltin.
- 410
SERVICE_DISCONTINUED
Service has been discontinuedHizmet kaldırıldı. Önce isteği düzeltin.
- 409
SERVICE_PAUSED
Service is temporarily unavailableHizmet şimdilik duraklatıldı. Daha sonra tekrar deneyin. Yeniden denemek işe yarayabilir.
- 503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily pausedSipariş verme herkes için kısa süreliğine duraklatıldı. Retry-After ne zaman yeniden deneyeceğinizi söyler. Yeniden denemek işe yarayabilir.
- 400
INVALID_LINK
Link is invalid for this serviceBağlantı bu hizmete uymuyor. Önce isteği düzeltin.
- 400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.Bağlantı engellenmiş. Bunun bir hata olduğunu düşünüyorsanız destekle iletişime geçin. Önce isteği düzeltin.
- 409
LINK_BUSY
An order for this link is still running. Wait until it finishes.Bu bağlantı için önceki bir sipariş hâlâ çalışıyor. Bitmesini bekleyin. Yeniden denemek işe yarayabilir.
- 400
MINIMUM_QUANTITY
Minimum quantity is {n}Miktar hizmetin en küçük değerinin altında. Önce isteği düzeltin.
- 400
MAXIMUM_QUANTITY
Maximum quantity is {n}Miktar hizmetin en büyük değerinin üstünde. Önce isteği düzeltin.
- 400
QUANTITY_STEP
Quantity must be a multiple of {step}Miktar hizmet adımının katı değil. Önce isteği düzeltin.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})Miktar, bir liste veya tepki alanındaki öğe sayısıyla eşleşmiyor. Önce isteği düzeltin.
- 400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}Sipariş, en düşük sipariş tutarından daha az değerde. Önce isteği düzeltin.
- 402
INSUFFICIENT_BALANCE
Insufficient balanceCüzdan bakiyesi ücretten düşük. Önce isteği düzeltin.
- 400
INVALID_OPTION
Invalid {param}: {rule}Bir ek alanın değeri geçersiz. details.param ve details.rule hangisi ve neden olduğunu söyler. Önce isteği düzeltin.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}Hizmet, gönderdiğiniz bir alanı kabul etmiyor. Önce isteği düzeltin.
- 400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this serviceHizmette kademeli gönderim yok veya bu miktar için yok. Önce isteği düzeltin.
- 400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not bothHer iki kademeli gönderim biçimi tek istekte gönderildi. Önce isteği düzeltin.
- 400
DRIP_FEED_INVALID
{rule}Kademeli gönderim değerleri sınırlara uymuyor. İleti hangi sınır olduğunu söyler. Önce isteği düzeltin.
- 429
ORDER_LIMIT_REACHED
Too many orders. Try again later.Aynı anda çok fazla sipariş verildi veya açık. Daha sonra tekrar deneyin. Yeniden denemek işe yarayabilir.
- 409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.Sipariş verilirken hizmet ayarları değişti. İsteği yeniden gönderin. Yeniden denemek işe yarayabilir.
- 409
REQUEST_ID_CONFLICT
request_id was already used with different parametersBu request_id zaten farklı parametrelerle bir sipariş oluşturdu. Önce isteği düzeltin.
Siparişler ve iptal
- 404
ORDER_NOT_FOUND
Order not foundBu numaralı hiçbir sipariş hesabınıza ait değil. Önce isteği düzeltin.
- 409
ORDER_FINISHED
Order is already {status}Sipariş zaten bitti. Önce isteği düzeltin.
- 409
CANCEL_NOT_AVAILABLE
Cancel is not available for this orderBu sipariş için iptal mümkün değil. Önce isteği düzeltin.
- 409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.İptal talebi reddedildi. details.time içindeki süreden sonra yeniden sorabilirsiniz. Yeniden denemek işe yarayabilir.
Yenilemeler
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderBu sipariş için yenileme mümkün değil. Önce isteği düzeltin.
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedYenileme, sipariş tamamlandıktan sonra mümkündür. Yeniden denemek işe yarayabilir.
- 409
REFILL_COOLDOWN
You can request a refill again after {time}Bu sipariş için yakın zamanda yenileme talep edildi. details.time sonrasında tekrar deneyin. Yeniden denemek işe yarayabilir.
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderBu sipariş için zaten devam eden bir yenileme var. Yeniden denemek işe yarayabilir.
- 404
REFILL_NOT_FOUND
Refill not foundBu kimliğe sahip hiçbir yenileme hesabınıza ait değil. Önce isteği düzeltin.
Webhook'lar
- 409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per accountHesap zaten izin verilen en fazla sayıda webhook uç noktasına sahip. Önce isteği düzeltin.
- 404
WEBHOOK_NOT_FOUND
Webhook not foundHesabınızda bu kimliğe sahip bir webhook uç noktası yok. Önce isteği düzeltin.
- 400
INVALID_WEBHOOK_URL
Invalid webhook URLURL herkese açık bir https adresi değil. Önce isteği düzeltin.