Πιστοποίηση API

Το Rivya API χρησιμοποιεί κλειδιά API για πρόσβαση από διακομιστή σε διακομιστή.

Ένα κλειδί API δεν είναι το ίδιο με μια περίοδο σύνδεσης στο πρόγραμμα περιήγησης. Μην χρησιμοποιείτε cookies, κατάσταση συνεδρίας Better Auth ή προσωπικό token προγράμματος περιήγησης ως δημόσιο διαπιστευτήριο API.

Μορφή header

Στείλτε το κλειδί στο header Authorization:

Authorization: Bearer rvya_sk_...

Το πλήρες κλειδί εμφανίζεται μόνο μία φορά όταν δημιουργείται. Το Rivya αποθηκεύει hash και ορατό prefix, όχι το πλήρες μυστικό.

Δημιουργία κλειδιού

1. Συνδεθείτε στο Rivya.
2. Ανοίξτε τις ρυθμίσεις API Keys.
3. Δημιουργήστε κλειδί με τα scopes που χρειάζεστε.
4. Αντιγράψτε αμέσως το πλήρες κλειδί.
5. Αποθηκεύστε το σε server-side secret manager ή μεταβλητή περιβάλλοντος.

Μην βάζετε το κλειδί σε client-side JavaScript, πακέτα εφαρμογών για κινητά, δημόσια repos, analytics events ή logs.

Τρέχοντα scopes

Η πρώτη έκδοση τεκμηριώνει αυτά τα scopes:

• models:read
• generations:create
• generations:read
• files:create
• files:read
• credits:read
• webhooks:manage
• chat:create
• chat:read

Τα νέα κλειδιά που δημιουργούνται στις ρυθμίσεις περιλαμβάνουν από προεπιλογή τα τεκμηριωμένα scopes. Παλαιότερα κλειδιά μπορεί να χρειάζεται να δημιουργηθούν ξανά πριν χρησιμοποιήσετε Files API, API Webhooks ή Chat API.

Ανάκληση και εναλλαγή

Αν εκτεθεί ένα κλειδί:

1. Ανακαλέστε το παλιό κλειδί από τις ρυθμίσεις.
2. Δημιουργήστε νέο κλειδί.
3. Ενημερώστε το server-side μυστικό σας.
4. Επιβεβαιώστε ότι το νέο κλειδί λειτουργεί με GET /api/v1/credits.
5. Αφαιρέστε το παλιό κλειδί από συστήματα build, logs και μεταβλητές deployment.

Τα ανακλημένα κλειδιά επιστρέφουν api_key_revoked.

Σφάλματα πιστοποίησης

Συνηθισμένα σφάλματα πιστοποίησης:

• api_key_missing
• api_key_invalid
• api_key_revoked
• api_key_expired
• api_scope_denied
• public_api_disabled

Δείτε Σφάλματα και όρια API για τον πλήρη δημόσιο πίνακα σφαλμάτων.

Σχετικές σελίδες

• Γρήγορη έναρξη API
• API Credits
• Σφάλματα και όρια API
• Πιστοποίηση και πρόσβαση στο Rivya