OpenAPI

Gateway menyajikan dokumen OpenAPI 3.1 di:

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

Dokumen ini disusun saat gateway dijalankan dari dokumen yang disumbangkan setiap layanan: path dan skema digabungkan, duplikat diberi namespace per layanan, dan setiap path yang ditandai internal (khusus mesh) dihapus. Kontribusi ditambahkan layanan demi layanan; keluarga yang belum berkontribusi muncul di referensi endpoint tetapi tidak di dokumen. Sampai dokumen mencakup seluruh permukaan API, anggap referensi endpoint sebagai daftar keluarga yang otoritatif dan halaman konvensi sebagai kontrak yang otoritatif.

Setiap kontrak RolChat, baik ada di dokumen maupun tidak, mengikuti konvensi: amplop, paginasi kursor, kunci idempotensi, header batas laju, dan kode kesalahan.