Hızlı başlangıç

1. Kimlik bilgilerini edininBölüm bağlantısını kopyala

Hesap → Davetler → API anahtarları bölümünden bir kişisel API anahtarı oluşturun. Gösterildiğinde kopyalayın ve betiğinize NINJABUY_API_KEY olarak aktarın; gizli tutun.

Başka NinjaBuy müşterileri adına işlem yapan bir uygulama için OAuth kullanın.

2. Bağlantıları anında oluşturunBölüm bağlantısını kopyala

curl -sS https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://weidian.com/item.html?itemID=7581746714"],"campaign":"spring-haul","label":"video 3"}'

En fazla 100 girdi için results, warnings ve request_id içeren 200 yanıtı döner. Her sonuçta input ve status bulunur; ok sonucu, hesabınıza atfedilen bağlantının url ve code değerlerini içerir. Her satırı kontrol edin: HTTP isteğinin başarılı olması tüm girdilerin dönüştürüldüğü anlamına gelmez. Bağlantılar sayfasına bakın.

3. Toplu iş başlatınBölüm bağlantısını kopyala

100'den fazla girdi, istek başına en fazla 2.000 olmak üzere otomatik olarak arka planda işlenir. Tek bağlantıyla bir işi denemek için async değerini true olarak ayarlayın:

curl -sS -D batch-headers.txt https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://www.ninjabuy.com/search?q=hoodie"],"async":true}'

Yanıt 202 olur. Location, /api/v1/jobs/JOB_ID gibi göreli bir yol verir; Retry-After: 5 ne zaman sorgulamanız gerektiğini belirtir. Gövdede job.id, job.status, job.total ve job.poll_after_seconds bulunur.

4. Sonuçları imleçle okuyunBölüm bağlantısını kopyala

Yanıttaki iş kimliğini kullanın. İlk istekte cursor göndermeyin:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Sonraki her istekte dönen, null olmayan imleci değiştirmeden iletin:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID?cursor=RETURNED_CURSOR" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Her sayfanın results değerini okuyun. has_more true ise sonraki sayfayı alın. False olduğu hâlde iş queued veya running durumundaysa poll_after_seconds kadar bekleyin ve sakladığınız imleçle tekrar sorgulayın. İş done veya failed durumuna geldiğinde ve tüm sayfalar okunduğunda durun. İşler ve Hatalar sayfalarına bakın.

Sonraki adımlarBölüm bağlantısını kopyala

Bir Google E-Tablosunu veya yüklenen XLSX/CSV dosyasını E-tablolar ile dönüştürün ya da Arama ile ürün bulun.