API SDK runtime
Jalur API untuk aplikasi klien (browser, Node.js, Electron, React Native) yang memakai header Authorization terdaftar di storage production, atau endpoint JSON/multipart umum di bawah /api/…. Halaman ini merangkum perbedaan runtime dan titik integrasi ke controller terkait.
← API (JSON) — ringkasan
· nodeApiControllerData()
· SdkController
Alur singkat SDK (Authorization)
- Request ke
/api/{…}dengan headerAuthorizationyang cocok satu baris di tabelproduction. ApiController→nodeApiControllerData()memilihSdkController(bukanControllerdari segmen URL pertama).- Kolom
method_get,method_post, … menentukan verb HTTP yang diizinkan; kedaluwarsa diexpirationmemblokir akses. - Method PHP di
SdkControllermengikuti slug URL / fallback verb (sama seperti pemetaan HTTP umum), ditambah aturan khusus mode SDK dinodeApiControllerData().
Matriks: kemampuan × runtime klien
Legenda: Ya didukung pola umum; Catatan perlu konfigurasi atau pustaka tambahan.
| Kemampuan | Web (browser) | Node.js | Electron | React Native |
|---|---|---|---|---|
JSON POST / GET ke /api/… |
Ya (fetch) |
Ya (fetch / axios) |
Ya (Chromium) | Ya (fetch) |
Header Authorization (SDK production) |
Ya | Ya | Ya | Ya |
Cookie / sesi PHP (ForgeController::red / OutsideController::red) |
Ya (same-origin, credentials: 'include') |
Catatan: tidak ada cookie browser; pakai jarak dekat proxy atau token | Ya jika origin mengarah ke backend yang sama | Catatan: cookie domain terbatas; biasanya token, bukan red |
multipart/form-data upload (CloudController) |
Ya (FormData) |
Ya (form-data / undici) |
Ya | Ya (FormData + URI file) |
CORS preflight OPTIONS |
Ya (diatur ApiController) |
Tidak relevan (non-browser) | Sama seperti Web jika origin beda | Tidak relevan |
SdkController::patch + build_query (Office) |
Ya | Ya | Ya | Ya |
NexaBig / routing dinamis (Forge / Outside) |
Ya | Ya | Ya | Ya |
Kapan pakai controller mana
| Controller | URL contoh | Peran ringkas |
|---|---|---|
SdkController |
/api/… + Authorization terdaftar |
Status lisensi, metadata app, patch query Office lewat build_query, stub CRUD SDK. |
CloudController |
/api/cloud/avatar, /api/cloud/add, … |
Upload file / avatar ke assets/drive, update record + thumbnail. |
ForgeController |
/api/forge/… |
Gateway JSON: NexaBig, routing dinamis ke controller/model, red untuk set sesi. |
OutsideController |
/api/outside/… |
Pola sama seperti Forge untuk klien eksternal (URL terpisah, kontrak bisa dipisah kebijakan). |
Lanjut
Dokumentasi per berkas: gunakan menu di kanan. Dasar routing API: API (JSON).