Siparişler
Sipariş verme
Sipariş verir ve parayı tek adımda tahsil eder. Yanıt hemen gelir: sipariş Beklemede olur ve ilk 15 saniye içinde ücretsiz iptal edilebilir. Yeniden denemenin asla ikinci bir sipariş oluşturmaması için kendi request_id değerinizi gönderin.
https://notpanel.com/api/v3action=add- API anahtarı gerekli
- İstek limiti aşıldı
- Gövde:
application/x-www-form-urlencoded
Parametreler
Her zaman gönderilir
keystringZorunlu- API anahtarınız.
actionstringZorunluaddBirebir "add" dizesi olmalıdır.
Sipariş
serviceintegerZorunlu- Hizmet listesindeki hizmet kimliği.
linkstringZorunlu- Teslimatın yapılacağı bağlantı. Neyin geçerli sayıldığı hizmete bağlıdır.
quantityintegerHizmet türüne bağlı- Toplam miktar.
runsveintervalile birlikte, çalıştırma başına miktardır. Listeler ve kesin tepkiler kendi miktarını sayar, paketlerin ise sabit bir miktarı vardır.
Yeniden denemeler
request_idstringİsteğe bağlı- Bu sipariş için kendi kimliğiniz, en fazla 128 karakter. Aynı parametrelerle tekrarlamak özgün siparişi döndürür. Farklı parametrelerle kullanmak
REQUEST_ID_CONFLICTdöndürür. idempotency_keystringİsteğe bağlırequest_idtakma adı. İkisi birlikte gönderilirserequest_idgeçerli olur.
Kademeli Gönderim
runsintegerİsteğe bağlı- Klasik kademeli gönderim: çalıştırma sayısı, 2 ile 100 arası.
runs=1normal bir sipariştir. intervalintegerİsteğe bağlı- Klasik kademeli gönderim: çalıştırmalar arası dakika, 1 ile 1440 arası.
drip_feed_total_minutesintegerİsteğe bağlı- Basit kademeli gönderim: tüm
quantitymiktarını bu kadar dakika içinde bitir, 1 ile 2880 arası.runsveintervalile birleştirmeyin.
Hizmetten gelen alanlar
reactionsstringİsteğe bağlı- Telegram tepkileri, örneğin
👍,❤️,🔥veya👍:60,❤️:40. comments, usernames, answer_number, …Hizmet türüne bağlı- Diğer ek alanlar, alan adlarıyla, örneğin
comments,usernamesveyaanswer_number. Hizmetinfieldslistesi hangilerini aldığını söyler.
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=1000&request_id=550e8400-e29b-41d4-a716-446655440000"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "add",
service: "7",
link: "https://instagram.com/example",
quantity: "1000",
request_id: "550e8400-e29b-41d4-a716-446655440000",
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={
"key": "YOUR_API_KEY",
"action": "add",
"service": "7",
"link": "https://instagram.com/example",
"quantity": "1000",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'add',
'service' => '7',
'link' => 'https://instagram.com/example',
'quantity' => '1000',
'request_id' => '550e8400-e29b-41d4-a716-446655440000',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
'ignore_errors' => true,
],
]));
print_r(json_decode($response, true));
YOUR_API_KEY yerine API sayfanızdaki anahtarı yazın.
{
"order": 1234567,
"status": "Pending",
"status_key": "pending",
"charge": "1.20",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}Hatalar
- 400
{"error":"Minimum quantity is 100","error_code":"MINIMUM_QUANTITY","retryable":false,"details":{"n":100}}Miktar hizmetin en küçük değerinin altında. Aynı yapı en büyük değeri, adımı ve diğer denetimleri de kapsar.
- 402
{"error":"Insufficient balance","error_code":"INSUFFICIENT_BALANCE","retryable":false}Cüzdan tutarı karşılamıyor. Hiçbir şey tahsil edilmedi ve sipariş oluşmadı.
/dashboard/walletsayfasından bakiye ekleyin. - 409
{"error":"request_id was already used with different parameters","error_code":"REQUEST_ID_CONFLICT","retryable":false}Bu
request_idfarklı parametrelerle zaten bir sipariş oluşturdu. Farklı bir sipariş için yeni birrequest_idkullanın.
Yanıt
Başarılı her add yeni siparişi hemen döndürür. Teslimata ilişkin iç ayrıntılar asla görünmez; sonraki değişiklikler status içinde ve webhook'larda görünür.
Yanıt alanları
orderinteger- Sipariş numarası. Panelde, destekte ve diğer tüm işlemlerde aynı numaradır.
statusstring- Yeni bir sipariş için
Pending. Tekrarlanan birrequest_idsiparişin güncel durumunu döndürür. status_keystring- Yeni bir sipariş için
pending; aksi halde güncel durumun anahtarı. chargestring- Sizden tahsil edilen tutar, USD cinsinden, metin olarak.
currencystring- Her zaman
USD. instant_cancel_untilstring (UTC time)- Ücretsiz iptal penceresinin sonu: siparişten 15 saniye sonra.
cancel_availableboolean- Sipariş hâlâ tam iadeyle iptal edilebildiği sürece
true. Eski betikler için korundu. cancel_window_secondsinteger- Ücretsiz iptal penceresinin saniye cinsinden süresi: 15. Eski betikler için korundu.
cancel_beforestring (UTC time)instant_cancel_untilile aynı zaman. Eski betikler için korundu.replayedboolean- Yalnızca bu, tekrarlanan bir
request_idiçin özgün siparişse bulunur ve true olur.
Yeniden denemeler ve request_id
request_id (veya takma adı idempotency_key, en fazla 128 karakter) her şeyden önce aranır. Aynı istek özgün siparişi döndürür ve hiçbir şey iki kez tahsil edilmez. Aynı kimliğe sahip farklı bir istek REQUEST_ID_CONFLICT döndürür. İki kopya aynı anda gelirse biri kazanır, diğeri aynı siparişi geri alır.
key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=1000&request_id=550e8400-e29b-41d4-a716-446655440000{
"order": 1234567,
"status": "In progress",
"status_key": "in_progress",
"charge": "1.20",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": false,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z",
"replayed": true
}key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=2000&request_id=550e8400-e29b-41d4-a716-446655440000{
"error": "request_id was already used with different parameters",
"error_code": "REQUEST_ID_CONFLICT",
"retryable": false
}Sipariş verdikten sonra
Sipariş Pending durumundadır ve ilk 15 saniye içinde tam iadeyle iptal edebilirsiniz. Sonradan bulunan sorunlar, örneğin yanlış veya meşgul bir bağlantı, reason_code ve otomatik iadeyle Canceled bir sipariş olarak gelir. Bunlar asla add hatası değildir.
Neler hangi sırayla denetlenir
Bulunan ilk sorun döndürülür ve hiçbir şey tahsil edilmez.
- Hizmet vardır ve sipariş alabilir:
SERVICE_NOT_FOUND,SERVICE_DISCONTINUED,SERVICE_PAUSED. - Miktar en küçük ve en büyük değer arasındadır:
MINIMUM_QUANTITY,MAXIMUM_QUANTITY. - Miktar adıma uyar:
QUANTITY_STEP. - Listeler ve kesin tepkiler: miktar öğe sayısıyla eşleşir,
QUANTITY_MISMATCH. - Ek alanlar sunulmuş ve geçerlidir:
OPTION_NOT_SUPPORTED,MISSING_PARAMETER,INVALID_OPTION. - Kademeli gönderim değerleri uyar:
DRIP_FEED_NOT_AVAILABLE,DRIP_FEED_CONFLICT,DRIP_FEED_INVALID. - Bağlantı hizmete uyar:
INVALID_LINK,LINK_BLOCKED. - Hizmette bu kural varsa bağlantı başına bir etkin sipariş:
LINK_BUSY. - Bakiye tutarı karşılar:
INSUFFICIENT_BALANCE.
add hataları
Hepsi ortak hata biçimini kullanır. error_code üzerinden dallanın; ileti metni insanlar içindir.
- 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.
- 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
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.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}Hizmet, gönderdiğiniz bir alanı kabul etmiyor. Ö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
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.
- 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.
- 402
INSUFFICIENT_BALANCE
Insufficient balanceCüzdan bakiyesi ücretten düşük. Ö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.
- 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.