Κλειδιά API
Χρησιμοποιήστε προσωπικό κλειδί API για να καλείτε το REST API από τα script σας.
Δημιουργία και ανάκληση κλειδιού
Συνδεθείτε στο NinjaBuy και ανοίξτε Λογαριασμός → Συστάσεις φίλων → Κλειδιά API για να δημιουργήσετε, να δείτε και να ανακαλέσετε ονομασμένα κλειδιά. Το πλήρες κλειδί αρχίζει με nb_ και εμφανίζεται μόνο μία φορά. Χρησιμοποιήστε την Αντιγραφή κλειδιού για να το αποθηκεύσετε με ασφάλεια πριν κλείσετε το μήνυμα.
Ένα κλειδί δεν λήγει ποτέ, εκτός αν επιλέξετε διάρκεια κατά τη δημιουργία του: 30 ημέρες, 90 ημέρες ή 1 έτος. Η ανάκληση ή η λήξη αυτής της διάρκειας ισχύει από το επόμενο αίτημα, και ένα κλειδί που έληξε εξαφανίζεται από τη λίστα.
Αποθηκεύεται μόνο ένα hash SHA-256 του κλειδιού.
Χρήση κλειδιού
Δώστε το κλειδί στο script σας ως NINJABUY_API_KEY και στείλτε το στην κεφαλίδα Authorization:
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"]}'Η ίδια κεφαλίδα λειτουργεί σε κάθε διαδρομή REST που απαιτεί έλεγχο ταυτότητας: Σύνδεσμοι, Αναζήτηση, μεταφορτώσεις και Υπολογιστικά φύλλα, καθώς και Εργασίες. Το έγγραφο OpenAPI δεν απαιτεί έλεγχο ταυτότητας.
Δικαιώματα και όρια
Κάθε κλειδί λαμβάνει και τα τρία δικαιώματα. Δεν υπάρχει επιλογή εύρους πρόσβασης.
| Δικαίωμα | Διαδρομές |
|---|---|
links:create | POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets |
jobs:read | GET /api/v1/jobs/{id} |
search:read | GET /api/v1/search |
Τα κλειδιά και τα αιτήματα OAuth REST μοιράζονται τα όρια δημιουργίας και αναζήτησης του λογαριασμού. Η δημιουργία συνδέσμων μέσω MCP μοιράζεται επίσης το όριο δημιουργίας. Δείτε τα Όρια αιτημάτων.
Ένα κλειδί δεν μπορεί να χρησιμοποιηθεί για σύνδεση, άνοιγμα συνεδρίας ή κλήση του MCP ή των API λογαριασμού. Χρησιμοποιήστε OAuth για εφαρμογή που ενεργεί για άλλους πελάτες NinjaBuy ή για πελάτη MCP.
Αποτυχίες
Ένα μη έγκυρο, ληγμένο ή ανακληθέν κλειδί επιστρέφει το ίδιο πρόβλημα 401 με ένα μη έγκυρο διακριτικό OAuth. Μια διακοπή της αποθήκευσης κλειδιών επιστρέφει 503 με Retry-After. Δείτε τα Σφάλματα.