跳转到内容

Αυθεντικοποίηση και κλειδιά API

Δημιουργήστε ένα κλειδί

Section titled “Δημιουργήστε ένα κλειδί”

Δημιουργήστε ένα κλειδί API sk_ στο Κέντρο API . Το πλήρες κλειδί εμφανίζεται μόνο μία φορά, όταν δημιουργείται ή ανανεώνεται.

Χρησιμοποιήστε ένα ξεχωριστό κλειδί για κάθε εφαρμογή, περιβάλλον και αυτοματοποιημένη εργασία, ώστε να μπορεί να έχει το δικό του προϋπολογισμό και να μπορεί να απενεργοποιείται, να ανακυκλώνεται και να ελέγχεται ανεξάρτητα.

Στείλτε το διαπιστευτήριο

Section titled “Στείλτε το διαπιστευτήριο”

Συνιστάται:

X-API-Key: sk_your_key

Η τυποποιημένη μορφή Bearer λειτουργεί επίσης:

Authorization: Bearer sk_your_key

Στείλτε μόνο ένα από τα δύο σε μια αίτηση.

Terminal window
curl https://omnidoc.top/api/v1/jobs \
-H "X-API-Key: $OMNIDOC_API_KEY"

Τι αντιπροσωπεύει ένα κλειδί

Section titled “Τι αντιπροσωπεύει ένα κλειδί”

Ένας κλειδί λειτουργεί για τον λογαριασμό που το δημιούργησε: μπορεί να καλέσει τις υπηρεσίες που επιτρέπεται στον λογαριασμό αυτό να χρησιμοποιεί και να έχει πρόσβαση μόνο στους πόρους αυτού του λογαριασμού. Ένας κλειδί δεν μπορεί να αλλάξει το email σύνδεσης, τον κωδικό πρόσβασης, τον αριθμό τηλεφώνου ή το προφίλ, και δεν μπορεί να δημιουργήσει, να περιστρέψει ή να ακυρώσει κλειδιά API.

Προαιρετικά όρια:

  • allowed_engines: μόνο οι παρατεθειμένες ρυθμίσεις μετάφρασης· ένα κενό πίνακα δεν προσθέτει κανένα όριο σε επίπεδο κλειδιού.
  • expires_at: χρόνος λήξης.
  • quota_limit: ο προϋπολογισμός διάρκειας ζωής του κλειδιού σε ολόκληρες χιλιοκρεντίτσες· 0 δεν ορίζει προϋπολογισμό σε επίπεδο κλειδιού, και τα κρεντίτσες του λογαριασμού εξοφλούνται κανονικά.

Περιστροφή και ανάκληση

Section titled “Περιστροφή και ανάκληση”

Δημιουργήστε κλειδιά, αλλάξτε τα όριά τους, περιστρέψτε ή ακυρώστε τα στο Κέντρο API . Μόλις ένα κλειδί ακυρωθεί, απενεργοποιηθεί ή λήξει, ή ο λογαριασμός του απενεργοποιηθεί, οι νέες αιτήσεις αποτυγχάνουν αμέσως.

Η περιστροφή δημιουργεί ένα νέο μυστικό και απενεργοποιεί το παλιό αμέσως· το νέο κλειδί διατηρεί τα αρχικά όρια και τον προϋπολογισμό που έχει ήδη χρησιμοποιηθεί. Ένα ληγμένο κλειδί δεν μπορεί να περιστραφεί· δημιουργήστε ένα νέο. Για ομαλή αλλαγή, δημιουργήστε ένα νέο κλειδί και αναπτύξτε το, επιβεβαιώστε ότι οι κλήσεις είναι επιτυχείς, στη συνέχεια ανακαλέστε το παλιό κλειδί.

  • Διατηρήστε τους κωδικούς μόνο στο διακομιστή ή σε ένα ελεγχόμενο περιβάλλον εκτέλεσης.
  • Χρησιμοποιήστε μεταβλητές περιβάλλοντος ή μια διαχειρίστρια μυστικών· ποτέ μην τοποθετείτε κλειδιά στον πηγαίο κώδικα, στα log, στα αρχεία που περιέχουν πληροφορίες για τον περιηγητή ή σε δημόσια αποθετήρια.
  • Ποτέ μην αποστείλετε τον κωδικό σε διευθύνσεις μεταφόρτωσης ή λήψης που επιστρέφονται από το API.
  • Καταχωρήστε το ID του κλειδιού, το ID της πρόσκλησης και το ID της λειτουργίας· ποτέ μην καταχωρείτε ολόκληρο το κλειδί.
  • Εάν κλειδί διαρρεύσει, αντικαταστήστε το αμέσως και ελέγξτε τις εργασίες και τις χρεώσεις του.