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ş
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.
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.
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.
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.
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.
Parametreler
Tür
Açıklama
key
Metin
Zorunlu. AQNAB API Anahtarınız.
action
Metin
必填。固定为 refill。
order
Metin
Tek sipariş kimliği; toplu işlemler için virgülle ayrılmış siparişleri kullanın.
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.
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.
Geçerli API Anahtarına ait hesabın kullanılabilir bakiyesini döndürür. Bakiye 4 ondalık basamaklı bir dizedir.
Parametreler
Tür
Açıklama
key
Metin
Zorunlu. AQNAB API Anahtarınız.
action
Metin
必填。固定为 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.
Parametreler
Tür
Açıklama
key
Metin
Zorunlu. AQNAB API Anahtarınız.
action
Metin
必填。固定为 add。
service
Metin
Zorunlu. services çağrısından dönen hizmet numarası, örn. AQ1-123.
link
Metin
Zorunlu. Herkese açık erişilebilir http veya https hedef bağlantısı.
quantity
Tam 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.
comments
Metin
Özel yorum hizmetlerinde zorunludur. Her satıra bir yorum yazın; toplam sınır 20,000 karakterdir. Boş satırlar adede dahil edilmez.
keywords
Metin
Özel anahtar kelime isteyen hizmetlerde zorunludur; en fazla 2,000 karakter girilebilir. Diğer hizmetlerde gerekli değildir.
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.
Parametreler
Tür
Açıklama
key
Metin
Zorunlu. AQNAB API Anahtarınız.
action
Metin
必填。固定为 status。
order
Metin
Zorunlu. Sipariş oluşturulurken dönen order alanı.
Parametreler geçersiz, hizmet kullanılamıyor veya bakiye yetersiz.
401
Anahtar geçersiz veya iptal edilmiş.
404
Mevcut hesaba ait sipariş bulunamadı.
500 / 502
Hizmet 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.