Γρήγορη εκκίνηση

1. Αποκτήστε διαπιστευτήριαΑντιγραφή συνδέσμου ενότητας

Δημιουργήστε ένα προσωπικό κλειδί API από Λογαριασμός → Συστάσεις φίλων → Κλειδιά API. Αντιγράψτε το όταν εμφανιστεί και δώστε το στο script σας ως NINJABUY_API_KEY· κρατήστε το μυστικό.

Για εφαρμογή που ενεργεί για άλλους πελάτες NinjaBuy, χρησιμοποιήστε OAuth.

2. Δημιουργήστε συνδέσμους άμεσαΑντιγραφή συνδέσμου ενότητας

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"}'

Έως 100 είσοδοι επιστρέφουν 200 με results, warnings και request_id. Κάθε αποτέλεσμα έχει input και status· ένα αποτέλεσμα ok περιλαμβάνει τα url και code του συνδέσμου με απόδοση παραπομπών. Ελέγξτε κάθε γραμμή: η επιτυχία HTTP δεν σημαίνει ότι μετατράπηκαν όλες οι είσοδοι. Δείτε τους Συνδέσμους.

3. Ξεκινήστε μια παρτίδαΑντιγραφή συνδέσμου ενότητας

Πάνω από 100 είσοδοι εκτελούνται αυτόματα στο παρασκήνιο, έως 2.000 ανά αίτημα. Για να δοκιμάσετε μια εργασία με έναν σύνδεσμο, ορίστε το async σε 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}'

Η απόκριση είναι 202. Το Location δίνει μια σχετική διαδρομή όπως /api/v1/jobs/JOB_ID· το Retry-After: 5 υποδεικνύει πότε να ελέγξετε ξανά. Το σώμα περιέχει job.id, job.status, job.total και job.poll_after_seconds.

4. Διαβάστε αποτελέσματα με δρομέαΑντιγραφή συνδέσμου ενότητας

Χρησιμοποιήστε το αναγνωριστικό εργασίας από την απόκριση. Παραλείψτε το cursor στο πρώτο αίτημα:

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

Σε κάθε επόμενο αίτημα, περάστε αυτούσιο τον μη κενό δρομέα που επιστράφηκε:

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

Διαβάστε τα results κάθε σελίδας. Όταν το has_more είναι true, ανακτήστε την επόμενη σελίδα. Όταν είναι false αλλά η εργασία είναι queued ή running, περιμένετε poll_after_seconds και ελέγξτε ξανά με τον αποθηκευμένο δρομέα. Σταματήστε αφού η εργασία γίνει done ή failed και διαβαστούν όλες οι σελίδες. Δείτε Εργασίες και Σφάλματα.

Επόμενα βήματαΑντιγραφή συνδέσμου ενότητας

Μετατρέψτε Google Sheet ή μεταφορτωμένο XLSX/CSV με τα Υπολογιστικά φύλλα ή βρείτε προϊόντα με την Αναζήτηση.