Başlarken

API v3, tanıdık key + action sözleşmesini JSON yanıtlarla korur. Mevcut bir reseller istemcisi temel URL'yi doğrudan değiştirebilir; gelişmiş v3 alanları ve action'ları isteğe bağlı uzantılardır.

1. 1. Bir hesap oluşturun

   Şu yolla ücretsiz kayıt: /register — e-posta veya Google OAuth. Bir API anahtarı oluşturmak için kredi kartı gerekmez, yalnızca canlı sipariş vermek üzere cüzdanı fonlamak için gerekir.

2. 2. Bir API anahtarı oluşturun

   Oturum açtıktan sonra /dashboard/api adresine gidin. "Generate key" (Anahtar oluştur) düğmesine tıklayın ve ham değeri kopyalayın — bir kez gösterilir, bir daha asla. Kaybederseniz anahtarı iptal edip yenisini oluşturun. Her kullanıcı en fazla 5 etkin anahtar tutabilir.

   Tüm anahtarlarınız hesabın dakikalık etkin istek limitini paylaşır. Ömür boyu başarılı harcama otomatik seviyeyi belirler; IP ve eylem limitleri de uygulanabilir — bkz. Hız limitleri.

3. 3. İlk isteğinizi yapın

   Uyumluluk için action=services, hesaba özel fiyat, min, max ve yetenek bayraklarıyla etkin servislerin önbelleklenmiş dizisini döndürür. Sayfalama, arama, kullanılabilirlik, platform/kategori meta verisi veya güncellik alanları gerektiğinde action=catalog kullanın. YOUR_API_KEY değerini 2. adımdaki anahtarla değiştirin.

   cURLJavaScriptPythonPHP

   # 1. List active catalog services
   curl -X POST https://notpanel.com/api/v3 \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "key=YOUR_API_KEY&action=services"

   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: "services",
     }),
   });
   
   const services = await res.json();
   console.log(`Found ${services.length} services`);

   import requests
   
   res = requests.post(
     "https://notpanel.com/api/v3",
     data={"key": "YOUR_API_KEY", "action": "services"},
   )
   services = res.json()
   print(f"Found {len(services)} services")

   <?php
   $body = http_build_query([
     'key' => 'YOUR_API_KEY',
     'action' => 'services',
   ]);
   
   $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,
     ],
   ]));
   
   $services = json_decode($response, true);
   echo "Found " . count($services) . " services\n";
   

   Bölgenizdeki kullanıcıların doğal anlayacağı adlar mı gerekiyor? services veya catalog isteğine language=tr (ya da en, es, pt, ru, ar, hi, id, fr, zh) ekleyin. Adlar gerçek pazar kullanımına göre seçilmiş pazar terminolojisiyle düzenlenir, markalar tanınır kalır ve yanıt kullanılan gerçek dili bildirir. Eski İngilizce biçimi değiştirmemek için parametreyi göndermeyin. Yöneticiler her adı inceleyebilir veya düzeltebilir.

4. 4. Bir sipariş verin

   Bir service seçin, wallet bakiyesini yükleyin ve tür alanlarıyla action=add çağırın. Eski istemciler tanıdık isteği değişmeden gönderebilir. Kesin retry kontrolü için en fazla 128 karakterlik benzersiz bir request_id isteğe bağlı olarak eklenebilir. Bkz. Sipariş verme tam parametre listesi için.

5. 5. İzleyin ve yanıt verin

   Yoklayın durum tek tek siparişler veya en fazla 100 ID'lik gruplar için. Olay-odaklı entegrasyonlar için bir webhook kaydedin; desteklenen altı olay: order.completed, order.partial, order.processing, order.in_progress, order.refunded ve order.refill_completed. Teslimat yeniden denemelerle en-iyi-çabadır; önemli durumu action=status ile uzlaştırın.