Szybki start
Twórz linki bezpośrednio, a następnie odbierz wyniki partii za pomocą curl.
1. Uzyskaj dane dostępu
Utwórz osobisty klucz API w Konto → Polecenia → Klucze API. Skopiuj go, gdy zostanie pokazany, i przekaż do skryptu jako NINJABUY_API_KEY; zachowaj go w tajemnicy.
Dla aplikacji działającej w imieniu innych klientów NinjaBuy używaj OAuth.
2. Utwórz linki bezpośrednio
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"}'Do 100 danych wejściowych zwraca 200 z results, warnings i request_id. Każdy wynik ma input i status; wynik ok zawiera przypisany url i code. Sprawdź każdy wiersz: sukces HTTP nie oznacza przekształcenia wszystkich danych. Zobacz Linki.
3. Uruchom partię
Ponad 100 danych wejściowych jest automatycznie przetwarzanych w tle, maksymalnie 2 000 na żądanie. Aby wypróbować zadanie z jednym linkiem, ustaw async na true:
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}'Odpowiedź ma status 202. Location podaje ścieżkę względną, taką jak /api/v1/jobs/JOB_ID; Retry-After: 5 wskazuje, kiedy odpytać ponownie. Treść zawiera job.id, job.status, job.total i job.poll_after_seconds.
4. Odczytaj wyniki za pomocą kursora
Użyj identyfikatora zadania z tej odpowiedzi. Pomiń cursor w pierwszym żądaniu:
curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID" \
-H "Authorization: Bearer $NINJABUY_API_KEY"W każdym kolejnym żądaniu przekaż zwrócony kursor bez zmian, jeśli nie jest null:
curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID?cursor=RETURNED_CURSOR" \
-H "Authorization: Bearer $NINJABUY_API_KEY"Odczytaj results każdej strony. Gdy has_more jest true, pobierz kolejną stronę. Gdy jest false, ale zadanie ma status queued lub running, odczekaj poll_after_seconds i odpytaj z zachowanym kursorem. Zakończ, gdy zadanie ma status done lub failed i odczytano wszystkie strony. Zobacz Zadania i Błędy.
Kolejne kroki
Konwertuj arkusz Google lub przesłany XLSX/CSV za pomocą Arkuszy albo znajdź produkty przez Wyszukiwanie.