OpenAPI

Η πύλη σερβίρει ένα έγγραφο OpenAPI 3.1 στη διεύθυνση:

GET https://api.rolchat.com/openapi.json

Συναρμολογείται κατά την εκκίνηση της πύλης από τα έγγραφα που συνεισφέρει κάθε υπηρεσία: οι διαδρομές και τα σχήματα συγχωνεύονται, τα διπλότυπα λαμβάνουν namespace ανά υπηρεσία και κάθε διαδρομή που έχει σημανθεί ως εσωτερική (μόνο για το mesh) αφαιρείται. Οι συνεισφορές προστίθενται υπηρεσία προς υπηρεσία· οι οικογένειες που δεν έχουν συνεισφέρει ακόμη εμφανίζονται στην αναφορά endpoints αλλά όχι στο έγγραφο. Μέχρι το έγγραφο να καλύψει ολόκληρη την επιφάνεια, θεωρήστε την αναφορά endpoints ως την έγκυρη λίστα οικογενειών και τη σελίδα συμβάσεων ως το έγκυρο συμβόλαιο.

Κάθε συμβόλαιο του RolChat, είτε βρίσκεται στο έγγραφο είτε όχι, ακολουθεί τις συμβάσεις: τον φάκελο, τη σελιδοποίηση με cursor, τα κλειδιά idempotency, τις κεφαλίδες ορίων ρυθμού και τους κωδικούς σφαλμάτων.