Dokumentasi / Standar & API / Standar Envelope API

🔌 Standar Envelope API

Format baku payload JSON API v1 untuk endpoint baru.

Standar & API SAKILA Ecosystem

Standar Envelope API SAKILA (Keputusan R6, 16 Sep 2026)

Bentuk baku (endpoint BARU)

Source / Snippet
{
  "success": true,
  "message": "Pesan ringkas.",
  "data": {},
  "meta": { "timestamp": "2026-09-16T10:00:00+07:00" }
}

Error: success: false + message + HTTP code yang tepat (404/422/429/403).

Aturan

  1. Endpoint mobile BARU wajib pakai bentuk di atas.
  2. Kontrak LAMA yang dimakan Flutter (MobileAuth, MobileApi) DIBEKUKAN —
    dilarang bungkus ulang tanpa update aplikasi HP bareng.
  3. Controller infra (Asterisk, Pbx, License, Relay, LegacyGateway,
    Certificate) dikecualikan — kontrak integrasi pihak ketiga.

Controller beku (jangan diubah bentuknya)

  • Api/MobileAuthController.php (OTP + token)
  • Api/MobileApiController.php (donasi mobile)
  • Api/MobileAdminController.php (25 json, sebagian dimakan web lama)

Contoh acuan yang sudah benar

  • Api/MobileInboxController.php (sendMessage, idempotent 200)
  • Api/MobileVolunteerDistributionController.php (ok(): success/message/data/meta)