AQNAB API entegrasyon rehberi

Bayiler, katalogu senkronize etmek, sipariş oluşturmak ve ilerlemeyi takip etmek için tek bir API kullanabilir. Genel dokümantasyon anahtarları içermez; siparişler hesap bakiyesiyle oluşturulur; anahtarı sunucu tarafında saklayın.

Hizmet senkronizasyonu ve sipariş

  1. Hizmet ID bilgisini, bin adet fiyatını, alt ve üst miktar sınırlarını, telafi koşullarını ve bağlantı biçimini almak için services çağrısını kullanın.
  2. Hizmet türüne göre genel sayfayı veya belirtilen içerik bağlantısını doldurun, ardından ekle ile gönderin. Sipariş, miktar, bağlantı ve bakiyeyi yeniden doğrular.
  3. Dönen AQNAB sipariş numarasını kaydedin; gerçek üst tedarikçi senkronizasyonundan sonraki durumu, başlangıç miktarını ve kalan miktarı görmek için status çağrısı yapın.
  4. Zaman aşımı veya belirsiz sonuç durumunda önce sorgulayıp manuel kontrol edin; doğrudan hat değiştirip tekrar sipariş vermeyin. Yalnızca siparişin alınmadığını doğruladıktan sonra başka bir hizmet seçip yeniden gönderin.

Minimum örnek çağrı

curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'

API: POST /api/v2; form veya JSON kabul eder, JSON döndürür. Bakiye sorgusu action=balance; sipariş action=add, service, link, quantity parametreleriyle; ilerleme action=status, order parametresiyle. Özel yorumlar için ayrıca comments, anahtar kelime hizmetleri için keywords gönderin.

Yenileme, iptal ve alt panel satın alımı

status, orders toplu sorgusunu destekler (en fazla 100 sipariş); refill için order veya orders, refill_status için refill veya refills, cancel için orders gönderin. Tamamlama ve iptal yalnızca hizmet destekliyorsa kabul edilir; başvurular asenkron kuyruğa girer, iptal başvurusu iade anlamına gelmez.

Her alt site API erişim sayfası ayrı bir gizli anahtar sağlar. Alt site anahtarları, o tedarikçi sitesine önceden yüklediğiniz satın alma bakiyesini kullanır ve siparişleri o sitenin fiyatlarıyla verir; diğer sitelerin veya ana sitenin bakiyelerini kullanmaz. Herhangi bir seviyedeki satın alma bakiyesi yetersizse, tüm kesinti reddedilir. Müşteri yüklemeleri, o tedarikçi sitesi için yapılandırılan tahsilat hesabına gider.

Blog yayını, dizin ve görsel API'leri

Acente yayın API'si taslak oluşturma, önizleme, düzenleme, yayınlama, listeleme ve silme işlemlerini destekler. Ayrı bir yayın anahtarı kullanır ve ana siteye veya belirli bir alt siteye kısıtlanabilir. Final makaleleri yayınlamadan önce taslakları test edin.

Tam temsilci API dokümantasyonunu ve alan tablosunu görüntüle →

Anahtar Yönetimi

AQNAB API V2

Geliştirici API Dokümantasyonu

Hizmet kataloğundan numarayı ve güncel hesap satış fiyatını alın, ardından aynı anahtarla sipariş verin ve sorgulayın.

HTTP yöntemi
POST
API URL
https://aqnab.com/api/v2
İstek Formatı
JSON veya form (application/x-www-form-urlencoded)
Yanıt formatı
JSON · Fiyat birimi USD
Doğrulama yöntemi
İstek gövdesinde gönderkey. Anahtar yalnızca sunucuda saklanır.

Eksik teslimat başvurusu refill

Yalnızca refill=true olarak işaretlenmiş ve üst tedarikçiye gönderilmiş bu hesaba ait siparişler desteklenir. Başvurular önce kuyruğa alınır; tedarikçi yanıtı belirsizse doğrulama beklenir, tekrar gönderilmez. orders ile 1–100 sipariş numarası toplu olarak iletilebilir.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 refill。
orderMetinTek sipariş kimliği; toplu işlemler için virgülle ayrılmış siparişleri kullanın.
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
Başarılı Yanıt Örneği
{
  "refill": "AQR-EXAMPLE"
}

Yenileme ilerlemesi refill_status

Pending, Completed, Rejected veya Pending review döndürür. refills için 1–100 tamamlama numarası toplu gönderilebilir.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 refill_status。
refillMetinYenileme başvurusunun döndürdüğü numara; toplu işlemler için refills kullanın.
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
Başarılı Yanıt Örneği
{
  "status": "Pending"
}

İptal talebi cancel

Yalnızca cancel=true olan ve final olmayan siparişler desteklenir. 1 dönüşü, isteğin kuyruğa alındığı anlamına gelir; iptal edildiği veya geri ödendiği anlamına gelmez. Sipariş durumunu kontrol etmeye devam edin.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 cancel。
ordersMetin1–100 sipariş numarası, virgülle ayrılmış.
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
Başarılı Yanıt Örneği
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

Hizmet listesi services

Mevcut hesabın kullanabileceği satış kataloğunu döndürür. Sipariş vermek için hizmet dizesini kullanın; rate, 1.000 birim başına USD satış fiyatıdır. required göründüğünde, sipariş parametrelerini bu listeye göre iletin. refill/cancel bayrakları, ürünün yeniden doldurma ve iptal taleplerini destekleyip desteklemediğini gösterir.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 services。
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
Başarılı Yanıt Örneği
[
  {
    "service": "AQ1-123",
    "name": "TikTok 粉丝",
    "type": "Default",
    "category": "TikTok - 粉丝",
    "rate": "0.900",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false
  },
  {
    "service": "AQ2-456",
    "name": "TikTok 自定义评论",
    "type": "Custom Comments",
    "category": "TikTok - 评论",
    "rate": "8.00",
    "min": 1,
    "max": 100,
    "refill": false,
    "cancel": false,
    "required": [
      "link",
      "comments"
    ]
  }
]

Bakiye Sorgula balance

Geçerli API Anahtarına ait hesabın kullanılabilir bakiyesini döndürür. Bakiye 4 ondalık basamaklı bir dizedir.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 balance。
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "balance"
}
Başarılı Yanıt Örneği
{
  "balance": "12.5000",
  "currency": "USD"
}

Sipariş Oluştur add

Gerçek sipariş oluştur ve bakiyeden düş. Toplam tutar = adet ÷ 1.000 × güncel binlik fiyat, dört ondalık basamağa yuvarlanır. Sipariş numarasını aldıktan sonra ileride sorgulamak için kaydet. İstek zaman aşımına uğrarsa, önce konsolda siparişi kontrol et ve mükerrer gönderimden kaçın.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 add。
serviceMetinZorunlu. services çağrısından dönen hizmet numarası, örn. AQ1-123.
linkMetinZorunlu. Herkese açık erişilebilir http veya https hedef bağlantısı.
quantityTam sayıStandart hizmetler için zorunludur, min ve max arasında olmalıdır. Özel yorumlar geçerli satır sayısına göre hesaplanır.
commentsMetinÖzel yorum hizmetlerinde zorunludur. Her satıra bir yorum yazın; toplam sınır 20,000 karakterdir. Boş satırlar adede dahil edilmez.
keywordsMetinÖzel anahtar kelime isteyen hizmetlerde zorunludur; en fazla 2,000 karakter girilebilir. Diğer hizmetlerde gerekli değildir.
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
Başarılı Yanıt Örneği
{
  "order": "API-EXAMPLE-4ABC"
}
Özel yorumlar ve anahtar kelimeler için örnek isteyin
Özel yorumlar
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
Özel anahtar kelimeler
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

Sipariş Durumunu Sorgula status

Yalnızca geçerli hesabın siparişlerini sorgulayabilirsiniz. Toplu sorgu için siparişleri virgülle ayırarak en fazla 100 sipariş geçirin; toplu sonuçlar sipariş kimliğine göre dizinlenir. Durumlar şunları içerir: Beklemede, Devam ediyor, Tamamlandı, Kısmi, İptal edildi. start_count ve remains, üst kaynak durum senkronizasyonundan gelir; dönene kadar null'dur. Üst kaynak durumu, gerçek teslimatın bağımsız kanıtı değildir.

ParametrelerTürAçıklama
keyMetinZorunlu. AQNAB API Anahtarınız.
actionMetin必填。固定为 status。
orderMetinZorunlu. Sipariş oluşturulurken dönen order alanı.
İstek Gövdesi (JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
Başarılı Yanıt Örneği
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

Hata Yönetimi

HTTP durumuAçıklama
400Parametreler geçersiz, hizmet kullanılamıyor veya bakiye yetersiz.
401Anahtar geçersiz veya iptal edilmiş.
404Mevcut hesaba ait sipariş bulunamadı.
500 / 502Hizmet geçici olarak kullanılamıyor. Sipariş isteği başarısız olursa, önce siparişlerinizi ve bakiyenizi kontrol edin.
Hata Yanıt Örneği
{
  "error": "Insufficient funds"
}
cURL form örneği
curl -X POST https://aqnab.com/api/v2 \
  --data-urlencode "key=YOUR_KEY" \
  --data-urlencode "action=services"

登录后管理下单密钥. Yayın anahtarı, site yöneticisi tarafından SEO optimizasyon bölümünde bağımsız olarak oluşturulur ve güvenli şekilde teslim edilir.

Sık Sorulan Sorular

API ile hangi işlemler yapılabilir?

/api/v2 şu işlemleri destekler: services, balance, add ve status. Hizmet eşitleme, güncel perakende fiyatlarını ve miktar sınırlarını getirir. add gerçek ve ücretli bir sipariş oluşturur; status tedarikçiden alınan son durumu gösterir.

Zaman aşımında hemen başka hizmete geçebilir miyim?

Hayır. Sipariş tedarikçi tarafından alınmış olabilir. Yeni sipariş oluşturmadan önce mevcut sipariş sorgulanmalı ve manuel olarak doğrulanmalıdır. Gönderim sonucu belirsizken sistem otomatik olarak başka rotadan tekrar satın almaz.

API anahtarını nasıl alırım?

Giriş yaptıktan sonra API erişim merkezinde hesap koşullarına göre sipariş anahtarı oluşturabilirsiniz. Blog yayınlama için ayrı bir yayınlama anahtarı kullanılır. Bu anahtar belirli bir panele sınırlandırılabilir ve ücretli sipariş oluşturamaz.

Bayiler doğrudan blog yazısı yayımlayabilir mi?

Yayınlama API ile taslak oluşturabilir, önizlemeyi kontrol ettikten sonra durumu published olarak güncelleyebilirsiniz. Listeleme, düzenleme, silme ve görsel yükleme desteklenir. Alanlar ve istek sınırları için API belgelerine bakın.

Hizmet ID bilgisi neden rastgele değiştirilemez?

Her hizmet ID bilgisi belirli bir hizmet ve tedarik rotasına karşılık gelir. Fiyatı, hedef bağlantısı, miktar sınırları ve destek koşulları farklı olabilir. Önce kataloğu eşitleyin, sonra dönen ID ve bağlantı biçimini kullanın. Numarayı tahmin etmeyin.

Hizmet kataloğu · API detaylı rehber · Beyaz etiketli alt panel