Εργασίες

Το GET https://www.ninjabuy.com/api/v1/jobs/{id} απαιτεί διακριτικό bearer του ίδιου λογαριασμού. Εργασίες που λείπουν, είναι άγνωστες ή ανήκουν σε άλλον λογαριασμό επιστρέφουν 404.

Κύκλος ζωήςΑντιγραφή συνδέσμου ενότητας

Το job περιλαμβάνει id, kind, status και startedAt, καθώς και προαιρετικά progress (done, total), finishedAt, result και error. Οι χρονικές σημάνσεις είναι χιλιοστά του δευτερολέπτου από την αρχή της εποχής Unix. Όσο η εργασία είναι σε αναμονή ή εκτελείται, τα poll_after_seconds και η κεφαλίδα Retry-After υποδεικνύουν τον χρόνο αναμονής· η αρχική σύσταση είναι 5 δευτερόλεπτα.

Οι παρτίδες συνδέσμων έχουν kind: "link_mints". Το τελικό result αναφέρει total, converted, failed και προαιρετικά campaign και label. Εδώ το failed μετρά εισόδους που απαντήθηκαν χωρίς μετατροπή· δεν σημαίνει ότι η κατάσταση ολόκληρης της εργασίας είναι failed. Οι μετατροπές υπολογιστικών φύλλων έχουν kind: "sheet_conversion"· το τελικό job.result περιέχει μετρήσεις και υπογεγραμμένο URL λήψης XLSX. Το σχήμα εργασιών καλύπτει επίσης τα sheet_read, picture_copy και resolution_run.

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

Η απόκριση περιέχει job, results, cursor, has_more και request_id. Κάθε σελίδα περιέχει έως 50 αποτελέσματα με τη σειρά εισόδου.

1. Παραλείψτε το cursor για την πρώτη σελίδα (μετατόπιση 0).
2. Επεξεργαστείτε τα results και κρατήστε κάθε μη κενό cursor που επιστρέφεται.
3. Όταν το has_more είναι true, ζητήστε την επόμενη σελίδα με ?cursor=RETURNED_CURSOR.
4. Αν το has_more είναι false ενώ η εργασία περιμένει ή εκτελείται, περιμένετε poll_after_seconds και ελέγξτε ξανά με τον αποθηκευμένο δρομέα. Νέα αποτελέσματα μπορεί να εμφανιστούν αργότερα.
5. Ολοκληρώστε μόνο όταν η εργασία είναι done ή failed και έχουν διαβαστεί όλες οι σελίδες αποτελεσμάτων (το cursor είναι null).

Ο δρομέας πρέπει να είναι μία μόνο παράμετρος ερωτήματος με 1 έως 6 ψηφία (0 έως 999999). Μη έγκυρες ή επαναλαμβανόμενες παράμετροι δρομέα επιστρέφουν 400. Μην εκλαμβάνετε μόνο το has_more: false ως ολοκλήρωση. Δείτε τα παραδείγματα curl.