{ "info": { "name": "BARATA Disaster Monitoring API", "description": "REST API v1 for BARATA disaster monitoring.\n\nDocs scope: Auth, RBAC, master data, disaster wizard, files, reporting/approval, publication, health, and volunteers.\nStandalone storage-file surfaces remain hidden until separately enabled.\n\nPersona namespaces:\n- `/api/v1/public/*` — citizen portal auth, public events (list/attention/nearby/detail), and health\n- `/api/v1/app/*` — internal dashboard (JWT + 2FA): RBAC, master dropdowns, wizard, files, reports, approvals, publications\n\nMaster taxonomy and regions are **app-only** (`/api/v1/app/master/*`, JWT). There is no public wizard master surface.\n\nDocumentation / Postman organization (English folders):\n- **PUBLIC** — citizen auth and public events\n- **INTERNAL** — health (ops placement), internal auth, session, RBAC, master data, disaster lifecycle, reports\n\nHealth is documented under **INTERNAL / 0. Health** for operators, but the runtime path remains\n`GET /api/v1/public/health` (unauthenticated).\n\nLifecycle playbook: `docs/api/disaster-input/README.md`.\n\n## Postman\nDownload Collection v2.1 + Local Environment from `/docs`, or:\n- `/postman/BARATA-API.postman_collection.json`\n- `/postman/BARATA-Local.postman_environment.json`\nImport both, select **BARATA Local**, then INTERNAL Auth login → verify-2fa.\n\nGenerated from `backend/public/docs.json`. Regenerate: `composer docs` (from `backend/`).\n\nPostman folders are nested **PUBLIC** then **INTERNAL** (English). Folder descriptions are short highlights — full playbooks live under `docs/api/`, especially `docs/api/disaster-input/README.md`.\n\n**Idempotency-Key (POST create/submit/publish):** use `{{$guid}}` for a fresh key per send; reuse only when retrying the exact same body.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_postman_id": "bb8115c6-3f4a-4d83-a8b1-cd59291793e1" }, "variable": [ { "key": "baseUrl", "value": "" }, { "key": "access_token", "value": "" }, { "key": "refresh_token", "value": "" }, { "key": "temp_token", "value": "" }, { "key": "district_code", "value": "" }, { "key": "subdistrict_code", "value": "" }, { "key": "village_code", "value": "" }, { "key": "disaster_type_id", "value": "" }, { "key": "disaster_name_id", "value": "" }, { "key": "event_id", "value": "" }, { "key": "event_version", "value": "" }, { "key": "impact_id", "value": "" }, { "key": "response_id", "value": "" }, { "key": "document_id", "value": "" }, { "key": "sk_kind", "value": "sk_tanggap_darurat" }, { "key": "file_upload_url", "value": "" }, { "key": "file_mime_type", "value": "image/jpeg" }, { "key": "report_id", "value": "" }, { "key": "publication_id", "value": "" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "if (!pm.request.headers.has('X-Request-ID')) {", " pm.request.headers.add({ key: 'X-Request-ID', value: pm.variables.replaceIn('{{$guid}}') });", "}" ] } } ], "item": [ { "name": "PUBLIC", "description": "**Actor:** citizen / public portal\n**Auth:** JWT after public login (no 2FA)\n**Flow:** register → verify email → login → public events\n**Playbook:** `docs/api/auth/public-README.md`, `docs/api/disaster-input/publication.md`", "item": [ { "name": "1. Auth", "description": "**Purpose:** public register, verify-email, login, forgot/reset, refresh, logout\n**Prereq:** none for register/login; JWT for logout\n**Vars:** `access_token`, `refresh_token`\n**Playbook:** `docs/api/auth/public-README.md`", "item": [ { "name": "01. Register public user (no JWT)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/register", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "register" ], "query": [], "variable": [] }, "description": "Create a new public user account (role `public`). Does not issue JWT. Sends email verification link and user must verify before POST /public/auth/login can succeed. Portal guide: docs/api/auth/public-README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"password\": \"SecurePassword123\",\n \"password_confirmation\": \"SecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/register", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "register" ], "query": [], "variable": [] }, "description": "Create a new public user account (role `public`). Does not issue JWT. Sends email verification link and user must verify before POST /public/auth/login can succeed. Portal guide: docs/api/auth/public-README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"password\": \"SecurePassword123\",\n \"password_confirmation\": \"SecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Verify public user email (requires query expires + signature)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/verify-email/:id/:hash?expires=1783996837&signature=baefe982fdaf47184ac0bef5a946b64cf92600cf3a38f67ebb9a47f3ad919b64", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "verify-email", ":id", ":hash" ], "query": [ { "key": "expires", "value": "1783996837", "description": "Unix timestamp from the signed email/portal link. REQUIRED with signature. Copied from portal `?expires=`.", "disabled": false }, { "key": "signature", "value": "baefe982fdaf47184ac0bef5a946b64cf92600cf3a38f67ebb9a47f3ad919b64", "description": "HMAC signature from the signed email/portal link (hex only). REQUIRED. Copied from portal `?signature=` — do not nest expires into this value. Without this query param the API returns 403 Invalid Signature.", "disabled": false } ], "variable": [ { "key": "id", "value": "", "description": "Path parameter" }, { "key": "hash", "value": "", "description": "Path parameter" } ] }, "description": "Verify public email (signed relative URL). Path: id (UUID) + hash (sha1 email). REQUIRED query: expires + signature from the email/portal link. Missing query → 403 Invalid Signature.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/verify-email/:id/:hash?expires=1783996837&signature=baefe982fdaf47184ac0bef5a946b64cf92600cf3a38f67ebb9a47f3ad919b64", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "verify-email", ":id", ":hash" ], "query": [ { "key": "expires", "value": "1783996837", "description": "Unix timestamp from the signed email/portal link. REQUIRED with signature. Copied from portal `?expires=`.", "disabled": false }, { "key": "signature", "value": "baefe982fdaf47184ac0bef5a946b64cf92600cf3a38f67ebb9a47f3ad919b64", "description": "HMAC signature from the signed email/portal link (hex only). REQUIRED. Copied from portal `?signature=` — do not nest expires into this value. Without this query param the API returns 403 Invalid Signature.", "disabled": false } ], "variable": [ { "key": "id", "value": "", "description": "Path parameter" }, { "key": "hash", "value": "", "description": "Path parameter" } ] }, "description": "Verify public email (signed relative URL). Path: id (UUID) + hash (sha1 email). REQUIRED query: expires + signature from the email/portal link. Missing query → 403 Invalid Signature.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Login public user (JWT, no 2FA)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/login", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "login" ], "query": [], "variable": [] }, "description": "Authenticate a citizen (`public` role) via email and password. Returns JWT access and refresh tokens immediately without 2FA only after email verification. Internal accounts receive HTTP 403 — use POST /app/auth/login. Unverified public accounts also receive HTTP 403. Portal guide: docs/api/auth/public-README.md.", "body": { "mode": "raw", "raw": "{\n \"email\": \"budi@example.com\",\n \"password\": \"SecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/login", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "login" ], "query": [], "variable": [] }, "description": "Authenticate a citizen (`public` role) via email and password. Returns JWT access and refresh tokens immediately without 2FA only after email verification. Internal accounts receive HTTP 403 — use POST /app/auth/login. Unverified public accounts also receive HTTP 403. Portal guide: docs/api/auth/public-README.md.", "body": { "mode": "raw", "raw": "{\n \"email\": \"budi@example.com\",\n \"password\": \"SecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "04. Request password reset email (public users only)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/forgot-password", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "forgot-password" ], "query": [], "variable": [] }, "description": "Request a password reset link for public (citizen) accounts only. Always returns HTTP 200 with a generic message (anti-enumeration). Internal accounts are ignored. Email link: {PUBLIC_PORTAL_URL}/reset-password?token=...&email=...", "body": { "mode": "raw", "raw": "{\n \"email\": \"john@example.com\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/forgot-password", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "forgot-password" ], "query": [], "variable": [] }, "description": "Request a password reset link for public (citizen) accounts only. Always returns HTTP 200 with a generic message (anti-enumeration). Internal accounts are ignored. Email link: {PUBLIC_PORTAL_URL}/reset-password?token=...&email=...", "body": { "mode": "raw", "raw": "{\n \"email\": \"john@example.com\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Reset password with email token (public users only)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/reset-password", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "reset-password" ], "query": [], "variable": [] }, "description": "Set a new password using token from reset email. Public users only. Revokes all refresh tokens. Does not auto-login — client must call POST /public/auth/login after success.", "body": { "mode": "raw", "raw": "{\n \"email\": \"john@example.com\",\n \"token\": \"\",\n \"password\": \"NewSecurePassword123\",\n \"password_confirmation\": \"NewSecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/reset-password", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "reset-password" ], "query": [], "variable": [] }, "description": "Set a new password using token from reset email. Public users only. Revokes all refresh tokens. Does not auto-login — client must call POST /public/auth/login after success.", "body": { "mode": "raw", "raw": "{\n \"email\": \"john@example.com\",\n \"token\": \"\",\n \"password\": \"NewSecurePassword123\",\n \"password_confirmation\": \"NewSecurePassword123\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Refresh access token", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/refresh", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "refresh" ], "query": [], "variable": [] }, "description": "Exchange a valid refresh_token for a new access_token and rotated refresh_token.", "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"opaque-refresh-token-from-login\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/refresh", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "refresh" ], "query": [], "variable": [] }, "description": "Exchange a valid refresh_token for a new access_token and rotated refresh_token.", "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"opaque-refresh-token-from-login\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "07. Logout and revoke tokens", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/logout", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "logout" ], "query": [], "variable": [] }, "description": "Invalidate current access token and revoke refresh tokens. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/auth/logout", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "auth", "logout" ], "query": [], "variable": [] }, "description": "Invalidate current access token and revoke refresh tokens. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "2. Public Events", "description": "**Purpose:** published events list/detail, attention feed, nearby spatial query\n**Prereq:** none (public reads)\n**Key query:** nearby uses `lat`, `lng`, `radius_km`\n**Playbook:** `docs/api/disaster-input/publication.md`", "item": [ { "name": "01. List published disaster events", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events" ], "query": [ { "key": "start", "value": "0", "description": "Pagination offset (0-indexed).", "disabled": true }, { "key": "length", "value": "10", "description": "Pagination page size (max 100).", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Search title or chronology.", "disabled": true }, { "key": "disaster_type_id", "value": "", "description": "Filter by disaster type UUID.", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Filter by regency region code.", "disabled": true }, { "key": "date_from", "value": "2026-08-01", "description": "Filter events occurred on or after YYYY-MM-DD.", "disabled": true }, { "key": "date_to", "value": "2026-08-31", "description": "Filter events occurred on or before YYYY-MM-DD.", "disabled": true } ], "variable": [] }, "description": "List published disaster events with start/length pagination, search, and filters. Unauthenticated. Playbook: docs/api/disaster-input/publication.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events" ], "query": [ { "key": "start", "value": "0", "description": "Pagination offset (0-indexed).", "disabled": true }, { "key": "length", "value": "10", "description": "Pagination page size (max 100).", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Search title or chronology.", "disabled": true }, { "key": "disaster_type_id", "value": "", "description": "Filter by disaster type UUID.", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Filter by regency region code.", "disabled": true }, { "key": "date_from", "value": "2026-08-01", "description": "Filter events occurred on or after YYYY-MM-DD.", "disabled": true }, { "key": "date_to", "value": "2026-08-31", "description": "Filter events occurred on or before YYYY-MM-DD.", "disabled": true } ], "variable": [] }, "description": "List published disaster events with start/length pagination, search, and filters. Unauthenticated. Playbook: docs/api/disaster-input/publication.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get public attention events feed", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/attention", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", "attention" ], "query": [], "variable": [] }, "description": "Pinned published disaster events as lightweight Attention Cards for the public home feed. Ordered by pin priority. No publication_id or pin metadata in response. Playbook: docs/api/events/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/attention", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", "attention" ], "query": [], "variable": [] }, "description": "Pinned published disaster events as lightweight Attention Cards for the public home feed. Ordered by pin priority. No publication_id or pin metadata in response. Playbook: docs/api/events/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. List published disaster events near GPS coordinates", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/nearby?lat=-6.9175&lng=107.6191&radius_km=25", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", "nearby" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Latitude in decimal degrees.", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Longitude in decimal degrees.", "disabled": false }, { "key": "radius_km", "value": "25", "description": "Search radius in kilometers (default 25).", "disabled": false }, { "key": "limit", "value": "10", "description": "Maximum number of items to return.", "disabled": true } ], "variable": [] }, "description": "Spatial query for published events near lat/lng within radius_km.\nUnauthenticated. Playbook: docs/api/disaster-input/publication.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/nearby?lat=-6.9175&lng=107.6191", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", "nearby" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Latitude in decimal degrees.", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Longitude in decimal degrees.", "disabled": false }, { "key": "radius_km", "value": "25", "description": "Search radius in kilometers (default 25).", "disabled": true }, { "key": "limit", "value": "10", "description": "Maximum number of items to return.", "disabled": true } ], "variable": [] }, "description": "Spatial query for published events near lat/lng within radius_km (default 25 km). Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get published disaster event detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Get detail of one public published disaster event.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Get detail of one public published disaster event.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "3. Public Infographics", "description": "**Purpose:** public infographics & statistics endpoints (summary, trends, distribution, breakdown, regions, notable, response, published events)\n**Prereq:** none (public reads)\n**Playbook:** `docs/api/infographics/README.md`", "item": [ { "name": "01. Get disaster summary statistics for public infographics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "summary" ], "query": [ { "key": "date_from", "value": "2026-01-01", "description": "", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve summary disaster statistics for citizen dashboard and infographics.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "summary" ], "query": [ { "key": "date_from", "value": "2026-01-01", "description": "", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve summary disaster statistics for citizen dashboard and infographics.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get disaster type distribution for public infographics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "types" ], "query": [ { "key": "date_from", "value": "", "description": "", "disabled": true }, { "key": "date_to", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster type breakdown and counts for public infographics chart.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "types" ], "query": [ { "key": "date_from", "value": "", "description": "", "disabled": true }, { "key": "date_to", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster type breakdown and counts for public infographics chart.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get regional disaster distribution for public infographics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "regions" ], "query": [ { "key": "date_from", "value": "", "description": "", "disabled": true }, { "key": "date_to", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve regency-level disaster counts for public infographics map/chart.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "regions" ], "query": [ { "key": "date_from", "value": "", "description": "", "disabled": true }, { "key": "date_to", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve regency-level disaster counts for public infographics map/chart.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. List published events for public infographics display", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "events" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster events for infographics portal data view.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "events" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster events for infographics portal data view.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Get published event breakdown for public infographics", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/infographics/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "infographics", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "4. Volunteer Registration", "description": "**Purpose:** public volunteer registration (personal/community) + cached count\n**Prereq:** none (public endpoints; no JWT or user credentials required)\n**Playbook:** `docs/api/volunteers/README.md`", "item": [ { "name": "01. Submit personal volunteer registration", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/register/personal", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "register", "personal" ], "query": [], "variable": [] }, "description": "Submit personal volunteer registration form.\nUnauthenticated. Playbook: docs/api/volunteers/README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Ahmad Hidayat\",\n \"nik\": \"3273010101900001\",\n \"email\": \"ahmad.hidayat@example.com\",\n \"phone\": \"081234567890\",\n \"gender\": \"L\",\n \"birth_date\": \"1990-05-15\",\n \"address\": \"Jl. Merdeka No. 12, Bandung\",\n \"region_code\": \"32.73.01.1001\",\n \"cluster_ids\": [\n \"00000000-0000-0000-0000-000000000001\"\n ],\n \"skills\": \"Pertolongan Pertama, Logistik\",\n \"notes\": \"Siap ditugaskan kapan saja\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/register/personal", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "register", "personal" ], "query": [], "variable": [] }, "description": "Submit personal volunteer registration form. Unauthenticated. Playbook: docs/api/volunteers/README.md.", "body": { "mode": "raw", "raw": "{\n \"nik\": \"3204011508950001\",\n \"full_name\": \"Budi Santoso\",\n \"birth_place\": \"Bandung\",\n \"birth_date\": \"1995-08-15\",\n \"gender\": \"pria\",\n \"blood_type\": \"O\",\n \"phone\": \"081234567890\",\n \"email\": \"budi.santoso@example.com\",\n \"address\": \"Jl. Raya Soreang No. 123\",\n \"regency_code\": \"32.04\",\n \"skills\": [\n \"medis\",\n \"sar\"\n ],\n \"medical_history\": \"Tidak ada riwayat penyakit berat\",\n \"emergency_contact_name\": \"Siti Aminah\",\n \"emergency_contact_phone\": \"081987654321\",\n \"privacy_consent\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Submit community volunteer organization registration", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/register/community", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "register", "community" ], "query": [], "variable": [] }, "description": "Submit community volunteer organization registration form.\nUnauthenticated. Playbook: docs/api/volunteers/README.md.", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"Relawan Kemanusiaan Bandung\",\n \"leader_name\": \"Budi Santoso\",\n \"email\": \"info@relawan-bandung.org\",\n \"phone\": \"081987654321\",\n \"address\": \"Jl. Asia Afrika No. 45, Bandung\",\n \"region_code\": \"32.73.01.1001\",\n \"member_count\": 25,\n \"cluster_ids\": [\n \"00000000-0000-0000-0000-000000000001\"\n ],\n \"description\": \"Komunitas relawan aksi cepat tanggap bencana\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/register/community", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "register", "community" ], "query": [], "variable": [] }, "description": "Submit community volunteer organization registration form. Unauthenticated. Playbook: docs/api/volunteers/README.md.", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"Tagana Kabupaten Bandung\",\n \"sk_number\": \"SK-BPBD/2024/089\",\n \"focus_areas\": [\n \"evakuasi\",\n \"dapur_umum\",\n \"logistik\"\n ],\n \"address\": \"Jl. Gajah Eretan No. 45, Soreang\",\n \"regency_code\": \"32.04\",\n \"lat\": -7.0311,\n \"lng\": 107.5255,\n \"pic_name\": \"Ahmad Hidayat\",\n \"pic_nik\": \"3204011204880003\",\n \"pic_phone\": \"081122334455\",\n \"pic_email\": \"ahmad.hidayat@example.com\",\n \"main_assets\": \"2 Perahu Karet, 1 Mobil Rescue, 3 Tenda Peleton\",\n \"privacy_consent\": true,\n \"members\": [\n {\n \"nik\": \"3204011508950011\",\n \"full_name\": \"Agus Pratama\",\n \"birth_place\": \"Bandung\",\n \"birth_date\": \"1995-08-15\",\n \"gender\": \"pria\",\n \"blood_type\": \"O\",\n \"phone\": \"081211112222\",\n \"email\": \"agus.pratama@example.com\",\n \"address\": \"Jl. Raya Soreang No. 10\",\n \"regency_code\": \"32.04\",\n \"district_code\": \"32.04.01\",\n \"village_code\": \"32.04.01.2001\",\n \"lat\": -7.0311,\n \"lng\": 107.5255,\n \"role_in_community\": \"Koordinator Lapangan\",\n \"skills\": [\n \"sar\",\n \"evakuasi\"\n ],\n \"medical_history\": \"Sehat\",\n \"emergency_contact_name\": \"Ibu Agus\",\n \"emergency_contact_phone\": \"081299991111\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get count of approved registered volunteers", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/count", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "count" ], "query": [], "variable": [] }, "description": "Return cached count of approved registered volunteers (personals and communities). Unauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/count", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "count" ], "query": [], "variable": [] }, "description": "Return cached count of approved registered volunteers (personals and communities). Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5. Information & Education", "description": "**Purpose:** public education list/detail, recommended mitigations near GPS\n**Prereq:** none (public reads)", "item": [ { "name": "01. Get recommended disaster education articles near GPS location", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education/recommended?lat=-6.9175&lng=107.6191&limit=5", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education", "recommended" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Citizen latitude.", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Citizen longitude.", "disabled": false }, { "key": "limit", "value": "5", "description": "Number of articles to return.", "disabled": false } ], "variable": [] }, "description": "Retrieve recommended disaster education articles for citizen location.\nUnauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education/recommended?lat=-6.9175&lng=107.6191", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education", "recommended" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Citizen latitude.", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Citizen longitude.", "disabled": false }, { "key": "limit", "value": "5", "description": "Number of articles to return.", "disabled": true } ], "variable": [] }, "description": "Retrieve recommended disaster education articles for citizen location based on regional disaster risk.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List disaster education articles", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "Gempa", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster education articles with start/length pagination and search.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "Gempa", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster education articles with start/length pagination and search.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get published disaster education article detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education/:slug_or_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education", ":slug_or_id" ], "query": [], "variable": [ { "key": "slug_or_id", "value": "", "description": "Path parameter" } ] }, "description": "Get detail of a published disaster education article by slug or ID.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/education/:slug_or_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "education", ":slug_or_id" ], "query": [], "variable": [ { "key": "slug_or_id", "value": "", "description": "Path parameter" } ] }, "description": "Get detail of a published disaster education article by slug or ID.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "6. Weather Forecast", "description": "**Purpose:** retrieve BMKG weather forecast for adm4 region code\n**Prereq:** none (public endpoint)\n**Playbook:** `docs/api/weather-forecast/README.md`", "item": [ { "name": "01. Get BMKG 3-day weather forecast by village region code", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/weather/forecast?adm4_code=32.04.01.2001", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "weather", "forecast" ], "query": [ { "key": "regency_code", "value": "32.73", "description": "Regency/City region code (level 2). Example: 32.73 (Kota Bandung), 32.01 (Kab. Bogor).", "disabled": true }, { "key": "district_code", "value": "32.73.01", "description": "District region code (level 3). Example: 32.73.01 (Sukajadi).", "disabled": true }, { "key": "adm4_code", "value": "32.04.01.2001", "description": "Village/Desa/Kelurahan region code (level 4). Example: 32.73.01.1001 (Pasteur).", "disabled": false } ], "variable": [] }, "description": "Retrieve 3-day BMKG weather forecast for village administrative code (adm4_code).\nAlways HTTP 200 with meta.availability_status fresh|stale|unavailable (empty lokasi/data when unavailable).\nMissing adm4_code → 422. Unauthenticated. Playbook: docs/api/weather-forecast/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/weather/forecast", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "weather", "forecast" ], "query": [ { "key": "regency_code", "value": "32.73", "description": "Regency/City region code (level 2). Example: 32.73 (Kota Bandung), 32.01 (Kab. Bogor).", "disabled": true }, { "key": "district_code", "value": "32.73.01", "description": "District region code (level 3). Example: 32.73.01 (Sukajadi).", "disabled": true }, { "key": "adm4_code", "value": "32.73.01.1001", "description": "Village/Desa/Kelurahan region code (level 4). Example: 32.73.01.1001 (Pasteur).", "disabled": true } ], "variable": [] }, "description": "Retrieve 3-day BMKG weather forecast for a single region. Defaults to West Java capital (Kota Bandung 32.73.01.1001) when no query parameters are passed. Optional query filters: regency_code (level 2), district_code (level 3), or adm4_code (level 4). Always HTTP 200 with fresh|stale|unavailable meta. Unauthenticated. Playbook: docs/api/weather/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"lokasi\": {\n \"adm1\": \"32\",\n \"adm2\": \"32.01\",\n \"adm3\": \"32.01.14\",\n \"adm4\": \"32.01.14.2002\",\n \"provinsi\": \"Jawa Barat\",\n \"kotkab\": \"Bogor\",\n \"kecamatan\": \"Leuwiliang\",\n \"desa\": \"Purasari\",\n \"lon\": 106.6013725154,\n \"lat\": -6.6993665694,\n \"timezone\": \"Asia/Jakarta\"\n },\n \"data\": [\n {\n \"lokasi\": {\n \"adm1\": \"32\",\n \"adm2\": \"32.01\",\n \"adm3\": \"32.01.14\",\n \"adm4\": \"32.01.14.2002\",\n \"provinsi\": \"Jawa Barat\",\n \"kotkab\": \"Bogor\",\n \"kecamatan\": \"Leuwiliang\",\n \"desa\": \"Purasari\",\n \"lon\": 106.6013725154,\n \"lat\": -6.6993665694,\n \"timezone\": \"+0700\",\n \"type\": \"adm4\"\n },\n \"cuaca\": [\n [\n {\n \"datetime\": \"2026-08-10T04:00:00Z\",\n \"t\": 26,\n \"tcc\": 61,\n \"tp\": 0.1,\n \"weather\": 2,\n \"weather_desc\": \"Cerah Berawan\",\n \"weather_desc_en\": \"Partly Cloudy\",\n \"wd_deg\": 4,\n \"wd\": \"N\",\n \"wd_to\": \"S\",\n \"ws\": 21.5,\n \"hu\": 56,\n \"vs\": 8538,\n \"vs_text\": \"< 9 km\",\n \"time_index\": \"3-4\",\n \"analysis_date\": \"2026-08-10T00:00:00\",\n \"image\": \"https://api-apps.bmkg.go.id/storage/icon/cuaca/cerah berawan-am.svg\",\n \"utc_datetime\": \"2026-08-10 04:00:00\",\n \"local_datetime\": \"2026-08-10 11:00:00\"\n }\n ]\n ]\n }\n ]\n },\n \"message\": \"Weather forecast retrieved successfully\",\n \"errors\": null,\n \"meta\": {\n \"request_id\": \"32c4d682-132d-450f-a496-d183f9cdbe0a\",\n \"source\": \"BMKG\",\n \"source_updated_at\": \"2026-08-10T09:00:00+07:00\",\n \"fetched_at\": \"2026-08-10T09:05:00+07:00\",\n \"availability_status\": \"fresh\"\n }\n}" } ] }, { "name": "02. Get public weather forecast along trip route (origin to destination)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/weather/route?origin_lat=-6.9175&origin_lng=107.6191&dest_lat=-6.1751&dest_lng=106.865", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "weather", "route" ], "query": [ { "key": "origin_lat", "value": "-6.9175", "description": "Origin latitude in decimal degrees (-11.0 to 6.0).", "disabled": false }, { "key": "origin_lng", "value": "107.6191", "description": "Origin longitude in decimal degrees (94.0 to 141.0).", "disabled": false }, { "key": "dest_lat", "value": "-6.1751", "description": "Destination latitude in decimal degrees (-11.0 to 6.0).", "disabled": false }, { "key": "dest_lng", "value": "106.865", "description": "Destination longitude in decimal degrees (94.0 to 141.0).", "disabled": false } ], "variable": [] }, "description": "Retrieve public trip route weather forecast between origin and destination coordinates. Provides encoded polyline, spatial waypoints with internal 10 km sampling, ETA weather based on current request time, active nowcasting warnings, and public safety status (Rute Aman / Rute Hati-Hati). Unauthenticated. Playbook: docs/api/weather/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/weather/route?origin_lat=-6.9175&origin_lng=107.6191&dest_lat=-6.1751&dest_lng=106.865", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "weather", "route" ], "query": [ { "key": "origin_lat", "value": "-6.9175", "description": "Origin latitude in decimal degrees (-11.0 to 6.0).", "disabled": false }, { "key": "origin_lng", "value": "107.6191", "description": "Origin longitude in decimal degrees (94.0 to 141.0).", "disabled": false }, { "key": "dest_lat", "value": "-6.1751", "description": "Destination latitude in decimal degrees (-11.0 to 6.0).", "disabled": false }, { "key": "dest_lng", "value": "106.865", "description": "Destination longitude in decimal degrees (94.0 to 141.0).", "disabled": false } ], "variable": [] }, "description": "Retrieve public trip route weather forecast between origin and destination coordinates. Provides encoded polyline, spatial waypoints with internal 10 km sampling, ETA weather based on current request time, active nowcasting warnings, and public safety status (Rute Aman / Rute Hati-Hati). Unauthenticated. Playbook: docs/api/weather/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7. Water Levels", "description": "**Purpose:** retrieve DSDA water levels for the server-configured basin (`DSDA_TMA_SENSOR_ID`)\n**Prereq:** none (public endpoint)\n**Playbook:** `docs/api/water-levels/README.md`", "item": [ { "name": "01. List river water level sensor readings", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/water-levels?search=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "water-levels" ], "query": [ { "key": "search", "value": "", "description": "", "disabled": false } ], "variable": [] }, "description": "Retrieve river water level sensor readings from DSDA (SIH3) for basin configured by DSDA_TMA_SENSOR_ID.\nAlways HTTP 200 with meta.availability_status fresh|stale|unavailable (empty data list when unavailable).\nUnauthenticated. Playbook: docs/api/water-levels/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/water-levels", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "water-levels" ], "query": [], "variable": [] }, "description": "Retrieve river water level sensor readings from DSDA (SIH3) for the basin configured by DSDA_TMA_SENSOR_ID (wilayah sungai UUID). Always HTTP 200 with meta.availability_status fresh|stale|unavailable (graceful fallback to latest DB snapshot if DSDA upstream is down). Unauthenticated. Playbook: docs/api/water-levels/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"data\": [\n {\n \"id\": 182607,\n \"waktu\": \"2024-03-12 00:00:00\",\n \"tinggi_muka_air\": 2.15,\n \"tma_sensor_id\": {\n \"nama\": \"Sensor Dayeuhkolot\"\n }\n }\n ]\n },\n \"message\": \"Water levels retrieved successfully\",\n \"errors\": null,\n \"meta\": {\n \"request_id\": \"32c4d682-132d-450f-a496-d183f9cdbe0a\",\n \"source\": \"DSDA\",\n \"source_updated_at\": \"2026-08-10T12:00:00+07:00\",\n \"fetched_at\": \"2026-08-10T12:05:00+07:00\",\n \"availability_status\": \"fresh\"\n }\n}" } ] } ] }, { "name": "8. Earthquakes (BMKG)", "description": "**Purpose:** latest BMKG earthquake (normalized DTO + freshness)\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/earthquakes/README.md`", "item": [ { "name": "01. Get latest BMKG earthquake report (normalized DTO)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/latest", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "latest" ], "query": [], "variable": [] }, "description": "Return latest BMKG earthquake as normalized DTO + freshness status.\nUnauthenticated. Playbook: docs/api/earthquakes/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/latest", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "latest" ], "query": [], "variable": [] }, "description": "Return the latest BMKG/SPLP earthquake as a normalized BARATA DTO (magnitude, status, ISO times, lat/lng, depth, description, instruction, freshness). Unauthenticated. Playbook: docs/api/earthquakes/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"waktu\": \"2026-08-11T12:00:00+07:00\",\n \"lintang\": \"-7.25\",\n \"bujur\": \"106.85\",\n \"magnitudo\": 5.2,\n \"kedalaman\": \"15 km\",\n \"wilayah\": \"75 km BaratDaya KAB-SUKABUMI-JABAR\",\n \"potensi\": \"Tidak berpotensi tsunami\",\n \"dirasakan\": \"MMI II-III Sukabumi, MMI II Pelabuhan Ratu\",\n \"shakemap\": \"20260811120000.gif\",\n \"is_tsunami\": false,\n \"nearest_region\": {\n \"name\": \"Kabupaten Sukabumi\",\n \"level\": 2,\n \"bps_code\": \"32.02\"\n }\n },\n \"message\": \"Latest earthquake retrieved\",\n \"errors\": null,\n \"meta\": {\n \"request_id\": \"32c4d682-132d-450f-a496-d183f9cdbe0a\",\n \"source\": \"BMKG\",\n \"source_updated_at\": \"2026-08-11T12:00:00+07:00\",\n \"fetched_at\": \"2026-08-11T12:05:00+07:00\",\n \"availability_status\": \"fresh\"\n }\n}" } ] }, { "name": "02. Get 30 M5.0+ earthquakes list from BMKG", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/m5", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "m5" ], "query": [], "variable": [] }, "description": "Return 30 recent earthquakes with magnitude >= 5.0 in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/m5", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "m5" ], "query": [], "variable": [] }, "description": "Return 30 recent earthquakes with magnitude >= 5.0 in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get 30 felt earthquakes list from BMKG", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/felt", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "felt" ], "query": [], "variable": [] }, "description": "Return 30 recent felt earthquakes with MMI intensity description in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/felt", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "felt" ], "query": [], "variable": [] }, "description": "Return 30 recent felt earthquakes with MMI intensity description in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get 30 tsunami potential earthquakes list from BMKG", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/tsunami", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "tsunami" ], "query": [], "variable": [] }, "description": "Return 30 recent earthquakes with tsunami potential history in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/earthquakes/tsunami", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "earthquakes", "tsunami" ], "query": [], "variable": [] }, "description": "Return 30 recent earthquakes with tsunami potential history in Indonesia as normalized DTO array. Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "9. GIS", "description": "**Purpose:** Offline geocoding / reverse geocoding\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/gis/README.md`", "item": [ { "name": "01. Resolve West Java administrative boundaries from GPS coordinates", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/gis/geocode?lat=-6.9175&lng=107.6191", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "gis", "geocode" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Latitude in decimal degrees (-90 to 90).", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Longitude in decimal degrees (-180 to 180).", "disabled": false } ], "variable": [] }, "description": "Resolve West Java administrative boundaries (province, regency, district, village) from GPS lat/lng coordinates.\nUnauthenticated. Playbook: docs/api/gis/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/gis/geocode?lat=-6.9175&lng=107.6191", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "gis", "geocode" ], "query": [ { "key": "lat", "value": "-6.9175", "description": "Latitude in decimal degrees (-90 to 90).", "disabled": false }, { "key": "lng", "value": "107.6191", "description": "Longitude in decimal degrees (-180 to 180).", "disabled": false } ], "variable": [] }, "description": "Resolve West Java administrative boundaries (province, regency, district, village) from GPS lat/lng decimal coordinates. Unauthenticated. Playbook: docs/api/gis/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"latitude\": -7.214,\n \"longitude\": 107.756,\n \"province\": {\n \"code\": \"32\",\n \"name\": \"JAWA BARAT\"\n },\n \"regency\": {\n \"code\": \"32.04\",\n \"name\": \"KAB. BANDUNG\"\n },\n \"district\": {\n \"code\": \"32.04.05\",\n \"name\": \"Kertasari\"\n },\n \"village\": {\n \"code\": \"32.04.05.2001\",\n \"name\": \"Tarumajaya\"\n }\n },\n \"message\": \"Coordinate geocoded successfully\",\n \"errors\": null,\n \"meta\": {\n \"request_id\": \"a90dfb19-ef87-43f1-b9a5-1049de5bc061\",\n \"timestamp\": \"2026-08-12T01:30:00+07:00\"\n }\n}" } ] } ] }, { "name": "10. Public Mitigation", "description": "**Purpose:** public disaster mitigation list and detail\n**Auth:** unauthenticated — no JWT", "item": [ { "name": "01. List disaster mitigation guides", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "mitigations" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "Tsunami", "description": "", "disabled": true }, { "key": "disaster_type_id", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster mitigation guides with start/length pagination and search.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "mitigations" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": true }, { "key": "length", "value": "10", "description": "", "disabled": true }, { "key": "search", "value": "Tsunami", "description": "", "disabled": true }, { "key": "disaster_type_id", "value": "", "description": "", "disabled": true } ], "variable": [] }, "description": "List published disaster mitigation guides with start/length pagination and search.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get published disaster mitigation guide detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/mitigations/:slug_or_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "mitigations", ":slug_or_id" ], "query": [], "variable": [ { "key": "slug_or_id", "value": "", "description": "Path parameter" } ] }, "description": "Retrieve details of a published disaster mitigation guide by its slug or ID, including all ordered media items (articles, youtube videos, images).", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/mitigations/:slug_or_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "mitigations", ":slug_or_id" ], "query": [], "variable": [ { "key": "slug_or_id", "value": "", "description": "Path parameter" } ] }, "description": "Retrieve details of a published disaster mitigation guide by its slug or ID, including all ordered media items (articles, youtube videos, images).", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "11. Evacuation Points", "description": "**Purpose:** nearest evacuation points for Leaflet / map routing (coordinates + distance_km)\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/public/evacuation-points.md`", "item": [ { "name": "01. List nearest evacuation points from GPS coordinates", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/evacuation-points/nearby?lat=-6.90025&lng=107.6187®ion_code=32.73&limit=5", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "evacuation-points", "nearby" ], "query": [ { "key": "lat", "value": "-6.90025", "description": "Latitude in decimal degrees.", "disabled": false }, { "key": "lng", "value": "107.6187", "description": "Longitude in decimal degrees.", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Region code prefix filter.", "disabled": false }, { "key": "radius_km", "value": "10", "description": "Optional maximum search radius in kilometers.", "disabled": true }, { "key": "limit", "value": "5", "description": "Maximum number of items to return (default 5, max 50).", "disabled": false } ], "variable": [] }, "description": "List nearest master evacuation points sorted by geodesic distance_km.\nUnauthenticated. Playbook: docs/api/public/evacuation-points.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/evacuation-points/nearby?lat=-6.90025&lng=107.6187®ion_code=32.73", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "evacuation-points", "nearby" ], "query": [ { "key": "lat", "value": "-6.90025", "description": "Latitude in decimal degrees.", "disabled": false }, { "key": "lng", "value": "107.6187", "description": "Longitude in decimal degrees.", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Region code prefix filter.", "disabled": false }, { "key": "radius_km", "value": "10", "description": "Optional maximum search radius in kilometers.", "disabled": true }, { "key": "limit", "value": "5", "description": "Maximum number of items to return (default 5, max 50).", "disabled": true } ], "variable": [] }, "description": "Return nearest master evacuation points for Leaflet map UIs. Required: lat, lng, region_code. Sorted by geodesic distance_km. Unauthenticated. Playbook: docs/api/public/evacuation-points.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "12. Call Centers", "description": "**Purpose:** resolve call-center contacts by GPS (+ optional kab region_code); WhatsApp + phone\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/public/call-centers.md`", "item": [ { "name": "01. List call centers for GPS location", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/call-centers/by-location?lat=-6.91&lng=107.61", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "call-centers", "by-location" ], "query": [ { "key": "lat", "value": "-6.91", "description": "User latitude WGS84 (-90..90).", "disabled": false }, { "key": "lng", "value": "107.61", "description": "User longitude WGS84 (-180..180).", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Optional active Jawa Barat kabupaten/kota code (level 2). When set, skips geocode.", "disabled": true } ], "variable": [] }, "description": "Resolve active call-center contacts for a GPS location (kab then province 32 fallback). Items include contact_type and contact_url (wa.me or tel:+).\nUnauthenticated. Playbook: docs/api/public/call-centers.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/call-centers/by-location?lat=-6.91&lng=107.61", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "call-centers", "by-location" ], "query": [ { "key": "lat", "value": "-6.91", "description": "User latitude WGS84 (-90..90).", "disabled": false }, { "key": "lng", "value": "107.61", "description": "User longitude WGS84 (-180..180).", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Optional active Jawa Barat kabupaten/kota code (level 2). When set, skips geocode.", "disabled": true } ], "variable": [] }, "description": "Resolve active master_call_centers for GPS location (WhatsApp and phone). Optional kab region_code; empty kab falls back to province 32. Returns contact_type, phone_number, contact_url. Playbook: docs/api/public/call-centers.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List call centers with optional kab region_code", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/call-centers/by-location?lat=-6.91&lng=107.61®ion_code=32.73", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "call-centers", "by-location" ], "query": [ { "key": "lat", "value": "-6.91", "description": "User latitude WGS84 (-90..90).", "disabled": false }, { "key": "lng", "value": "107.61", "description": "User longitude WGS84 (-180..180).", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Optional active Jawa Barat kabupaten/kota code (level 2). When set, skips geocode.", "disabled": false } ], "variable": [] }, "description": "Same as by-location but skip geocode when region_code (kab/kota) is provided.\nUnauthenticated. Playbook: docs/api/public/call-centers.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/call-centers/by-location?lat=-6.91&lng=107.61", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "call-centers", "by-location" ], "query": [ { "key": "lat", "value": "-6.91", "description": "User latitude WGS84 (-90..90).", "disabled": false }, { "key": "lng", "value": "107.61", "description": "User longitude WGS84 (-180..180).", "disabled": false }, { "key": "region_code", "value": "32.73", "description": "Optional active Jawa Barat kabupaten/kota code (level 2). When set, skips geocode.", "disabled": true } ], "variable": [] }, "description": "Resolve active master_call_centers for GPS location (WhatsApp and phone). Optional kab region_code; empty kab falls back to province 32. Returns contact_type, phone_number, contact_url. Playbook: docs/api/public/call-centers.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "13. Homepage Background", "description": "**Purpose:** retrieve active published hero background image metadata and MinIO URL\n**Auth:** unauthenticated — no JWT", "item": [ { "name": "01. Get active published homepage background hero image", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/homepage-background", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "homepage-background" ], "query": [], "variable": [] }, "description": "Retrieve currently active published hero background image metadata and MinIO URL for public homepage UI.\nUnauthenticated.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/homepage-background", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "homepage-background" ], "query": [], "variable": [] }, "description": "Retrieve currently active published hero background image DTO and MinIO S3 URL for public homepage UI rendering. Unauthenticated.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "14. Logistics (SPLP Dinsos)", "description": "**Purpose:** public disaster logistics vehicle/equipment/inventories assets, stock balances, and summary totals\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/logistics/README.md`", "item": [ { "name": "01. List disaster logistics vehicle assets", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/vehicles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "vehicles" ], "query": [ { "key": "start", "value": "0", "description": "Offset pagination.", "disabled": true }, { "key": "length", "value": "10", "description": "Items per page (max 100).", "disabled": true }, { "key": "search", "value": "Dapur Umum", "description": "Keyword search.", "disabled": true }, { "key": "source_institution", "value": "Dinas Sosial Provinsi Jawa Barat", "description": "Filter by institution.", "disabled": true }, { "key": "condition", "value": "", "description": "Filter by condition.", "disabled": true }, { "key": "operational_status", "value": "", "description": "Filter by status.", "disabled": true }, { "key": "regency_code", "value": "32.73", "description": "Filter by regency code.", "disabled": true }, { "key": "lat", "value": "-6.9175", "description": "Latitude for spatial radius.", "disabled": true }, { "key": "lng", "value": "107.6191", "description": "Longitude for spatial radius.", "disabled": true }, { "key": "radius_km", "value": "10", "description": "Spatial radius in kilometers.", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster logistics vehicle assets (operational status, condition, vehicle type, regency/district location, spatial geolocation radius filter). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/vehicles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "vehicles" ], "query": [ { "key": "start", "value": "0", "description": "Offset pagination.", "disabled": true }, { "key": "length", "value": "10", "description": "Items per page (max 100).", "disabled": true }, { "key": "search", "value": "Dapur Umum", "description": "Keyword search.", "disabled": true }, { "key": "source_institution", "value": "Dinas Sosial Provinsi Jawa Barat", "description": "Filter by institution.", "disabled": true }, { "key": "condition", "value": "", "description": "Filter by condition.", "disabled": true }, { "key": "operational_status", "value": "", "description": "Filter by status.", "disabled": true }, { "key": "regency_code", "value": "32.73", "description": "Filter by regency code.", "disabled": true }, { "key": "lat", "value": "-6.9175", "description": "Latitude for spatial radius.", "disabled": true }, { "key": "lng", "value": "107.6191", "description": "Longitude for spatial radius.", "disabled": true }, { "key": "radius_km", "value": "10", "description": "Spatial radius in kilometers.", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster logistics vehicle assets (operational status, condition, vehicle type, regency/district location, spatial geolocation radius filter). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List disaster logistics non-vehicle equipment assets", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/equipment", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "equipment" ], "query": [ { "key": "category", "value": "Tenda", "description": "Filter by category.", "disabled": true }, { "key": "condition", "value": "Baik", "description": "Filter by condition.", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster logistics equipment assets (tents, rubber boats, generators, field kitchens). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/equipment", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "equipment" ], "query": [ { "key": "category", "value": "Tenda", "description": "Filter by category.", "disabled": true }, { "key": "condition", "value": "Baik", "description": "Filter by condition.", "disabled": true } ], "variable": [] }, "description": "Retrieve disaster logistics equipment assets (tents, rubber boats, generators, field kitchens). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. List disaster logistics consumable inventory items", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/inventories", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "inventories" ], "query": [ { "key": "stock_status", "value": "", "description": "Filter stock status.", "disabled": true } ], "variable": [] }, "description": "Retrieve consumable disaster logistics items (food, clothing, shelter, health). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/inventories", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "inventories" ], "query": [ { "key": "stock_status", "value": "", "description": "Filter stock status.", "disabled": true } ], "variable": [] }, "description": "Retrieve consumable disaster logistics items (food, clothing, shelter, health). Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get disaster logistics summary totals and filter dropdown options", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "summary" ], "query": [], "variable": [] }, "description": "Retrieve aggregate total counts and dynamic filter metadata lists for frontend dropdowns. Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "summary" ], "query": [], "variable": [] }, "description": "Retrieve aggregate total counts and dynamic filter metadata lists for frontend dropdowns. Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. List warehouse disaster logistics stock balances", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/balances", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "balances" ], "query": [ { "key": "warehouse_name", "value": "Cimahi", "description": "Filter by warehouse.", "disabled": true } ], "variable": [] }, "description": "Retrieve logistics stock balances per warehouse. Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/logistics/balances", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "logistics", "balances" ], "query": [ { "key": "warehouse_name", "value": "Cimahi", "description": "Filter by warehouse.", "disabled": true } ], "variable": [] }, "description": "Retrieve logistics stock balances per warehouse. Unauthenticated. Playbook: docs/api/logistics/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "15. Geohazard Landslide (PVMBG)", "description": "**Purpose:** public monthly landslide potency statistics summary, high-risk regencies, and GeoServer WMS tile proxy\n**Auth:** unauthenticated — no JWT\n**Playbook:** `docs/api/geohazard/README.md`", "item": [ { "name": "01. Get monthly landslide potency statistics and alert banner", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "summary" ], "query": [ { "key": "year", "value": "2026", "description": "Forecast year", "disabled": true }, { "key": "month", "value": "8", "description": "Forecast month (1-12)", "disabled": true } ], "variable": [] }, "description": "Retrieve aggregated counts for landslide risk levels (Tinggi, Menengah, Rendah, Aman) and seasonal warning banner based on PVMBG forecast. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "summary" ], "query": [ { "key": "year", "value": "2026", "description": "Forecast year", "disabled": true }, { "key": "month", "value": "8", "description": "Forecast month (1-12)", "disabled": true } ], "variable": [] }, "description": "Retrieve aggregated counts for landslide risk levels (Tinggi, Menengah, Rendah, Aman) and seasonal warning banner based on PVMBG forecast. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List high-risk regencies and affected districts for landslide forecast", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "regions" ], "query": [ { "key": "year", "value": "2026", "description": "", "disabled": true }, { "key": "month", "value": "8", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve list of regencies in West Java sorted by highest landslide risk level with list of affected districts. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "regions" ], "query": [ { "key": "year", "value": "2026", "description": "", "disabled": true }, { "key": "month", "value": "8", "description": "", "disabled": true } ], "variable": [] }, "description": "Retrieve list of regencies in West Java sorted by highest landslide risk level with list of affected districts. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Proxy GeoServer WMS map tile layer for landslide hazard overlay", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/wms?service=WMS&request=GetMap&layers=stakeholder_pvmbg%3AJabar_Zonasi&format=image%2Fpng&transparent=true&version=1.1.1&width=256&height=256&srs=EPSG%3A4326&bbox=106.8%2C-7.5%2C108.5%2C-6.0", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "wms" ], "query": [ { "key": "service", "value": "WMS", "description": "", "disabled": false }, { "key": "request", "value": "GetMap", "description": "", "disabled": false }, { "key": "layers", "value": "stakeholder_pvmbg:Jabar_Zonasi", "description": "", "disabled": false }, { "key": "format", "value": "image/png", "description": "", "disabled": false }, { "key": "transparent", "value": "true", "description": "", "disabled": false }, { "key": "version", "value": "1.1.1", "description": "", "disabled": false }, { "key": "width", "value": "256", "description": "", "disabled": false }, { "key": "height", "value": "256", "description": "", "disabled": false }, { "key": "srs", "value": "EPSG:4326", "description": "", "disabled": false }, { "key": "bbox", "value": "106.8,-7.5,108.5,-6.0", "description": "", "disabled": false } ], "variable": [] }, "description": "Securely proxies GeoServer WMS requests to SPLP PVMBG with server-side API Key protection. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/geohazard/landslide/wms", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "geohazard", "landslide", "wms" ], "query": [], "variable": [] }, "description": "Securely proxies GeoServer WMS requests to SPLP PVMBG with server-side API Key protection. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "INTERNAL", "description": "**Actor:** BPBD / internal operators\n**Auth:** JWT after login → verify-2fa (or first-time 2fa/confirm)\n**Flow:** auth → master → wizard Steps 1–3 → files → report → approval → publication\n**Playbook:** `docs/api/disaster-input/README.md`", "item": [ { "name": "0. Health", "description": "**Purpose:** liveness/ops check (folder is INTERNAL for operators only)\n**Auth:** unauthenticated — no JWT\n**Path:** `GET /api/v1/public/health` (runtime stays public)\n**Note:** documentation placement ≠ authenticated surface", "item": [ { "name": "01. List Health", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/health", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "health" ], "query": [], "variable": [] }, "description": "Return a list of Health. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/health", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "health" ], "query": [], "variable": [] }, "description": "Return a list of Health. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"status\": \"ok\"\n}" } ] } ] }, { "name": "1. Auth - Internal", "description": "**Purpose:** internal login, verify-2fa, first-time 2FA setup/confirm, 2FA status/disable\n**Prereq:** admin credentials in env; OTP from authenticator\n**Vars:** `temp_token` → then `access_token` / `refresh_token`\n**Playbook:** `docs/api/auth/README.md`", "item": [ { "name": "01. Login internal user (step 1 — temp_token + 2FA)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/login", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "login" ], "query": [], "variable": [] }, "description": "Authenticate an internal dashboard user (step 1). Returns requires_2fa or requires_2fa_setup plus temp_token (5 min TTL). Does not issue JWT until verify-2fa or 2fa/confirm. Public accounts receive HTTP 403 — use POST /public/auth/login. Internal guide: docs/api/auth/README.md.", "body": { "mode": "raw", "raw": "{\n \"email\": \"{{admin_email}}\",\n \"password\": \"{{admin_password}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/login", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "login" ], "query": [], "variable": [] }, "description": "Authenticate an internal dashboard user (step 1). Returns requires_2fa or requires_2fa_setup plus temp_token (5 min TTL). Does not issue JWT until verify-2fa or 2fa/confirm. Public accounts receive HTTP 403 — use POST /public/auth/login. Internal guide: docs/api/auth/README.md.", "body": { "mode": "raw", "raw": "{\n \"email\": \"{{admin_email}}\",\n \"password\": \"{{admin_password}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('temp_token', payload.temp_token);", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "02. Verify 2FA OTP (routine login step 2)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/verify-2fa", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "verify-2fa" ], "query": [], "variable": [] }, "description": "Complete routine internal login (step 2). Send temp_token from POST /app/auth/login plus 6-digit OTP from Google Authenticator. Returns access_token and refresh_token. No Authorization header required.", "body": { "mode": "raw", "raw": "{\n \"temp_token\": \"{{temp_token}}\",\n \"otp_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/verify-2fa", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "verify-2fa" ], "query": [], "variable": [] }, "description": "Complete routine internal login (step 2). Send temp_token from POST /app/auth/login plus 6-digit OTP from Google Authenticator. Returns access_token and refresh_token. No Authorization header required.", "body": { "mode": "raw", "raw": "{\n \"temp_token\": \"{{temp_token}}\",\n \"otp_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "03. Setup 2FA enrollment (first-time)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/setup", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "setup" ], "query": [], "variable": [] }, "description": "Start first-time 2FA enrollment after internal login returns requires_2fa_setup. Send temp_token in body (not JWT). Returns qr_code_uri and secret for frontend QR rendering.", "body": { "mode": "raw", "raw": "{\n \"temp_token\": \"{{temp_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/setup", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "setup" ], "query": [], "variable": [] }, "description": "Start first-time 2FA enrollment after internal login returns requires_2fa_setup. Send temp_token in body (not JWT). Returns qr_code_uri and secret for frontend QR rendering.", "body": { "mode": "raw", "raw": "{\n \"temp_token\": \"{{temp_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('temp_token', payload.temp_token);", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "04. Confirm 2FA enrollment (first-time, issues JWT)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/confirm", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "confirm" ], "query": [], "variable": [] }, "description": "Finish first-time 2FA enrollment. Send temp_token plus otp_code from Google Authenticator. On success enables 2FA and returns access_token and refresh_token (no re-login needed).", "body": { "mode": "raw", "raw": "{\n \"otp_code\": \"123456\",\n \"temp_token\": \"{{temp_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/confirm", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "confirm" ], "query": [], "variable": [] }, "description": "Finish first-time 2FA enrollment. Send temp_token plus otp_code from Google Authenticator. On success enables 2FA and returns access_token and refresh_token (no re-login needed).", "body": { "mode": "raw", "raw": "{\n \"otp_code\": \"123456\",\n \"temp_token\": \"{{temp_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "05. Get 2FA enrollment status", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "status" ], "query": [], "variable": [] }, "description": "Return whether 2FA is enabled and enrollment timestamp. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "status" ], "query": [], "variable": [] }, "description": "Return whether 2FA is enabled and enrollment timestamp. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Disable 2FA (admin)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/disable", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "disable" ], "query": [], "variable": [] }, "description": "Disable 2FA for the authenticated admin after OTP verification. Requires JWT Bearer and auth.2fa.disable permission.", "body": { "mode": "raw", "raw": "{\n \"otp_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/2fa/disable", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "2fa", "disable" ], "query": [], "variable": [] }, "description": "Disable 2FA for the authenticated admin after OTP verification. Requires JWT Bearer and auth.2fa.disable permission.", "body": { "mode": "raw", "raw": "{\n \"otp_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "2. Auth - Session", "description": "**Purpose:** app refresh token rotation and logout\n**Prereq:** valid `refresh_token` / JWT\n**Note:** public refresh/logout live under PUBLIC / 1. Auth\n**Playbook:** `docs/api/auth/README.md`", "item": [ { "name": "01. Refresh access token", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/refresh", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "refresh" ], "query": [], "variable": [] }, "description": "Exchange a valid refresh_token for a new access_token and rotated refresh_token.", "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"opaque-refresh-token-from-login\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/refresh", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "refresh" ], "query": [], "variable": [] }, "description": "Exchange a valid refresh_token for a new access_token and rotated refresh_token.", "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"opaque-refresh-token-from-login\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('access_token', payload.access_token);", "saveEnv('refresh_token', payload.refresh_token);" ] } } ] }, { "name": "02. Logout and revoke tokens", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/logout", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "logout" ], "query": [], "variable": [] }, "description": "Invalidate current access token and revoke refresh tokens. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/auth/logout", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "auth", "logout" ], "query": [], "variable": [] }, "description": "Invalidate current access token and revoke refresh tokens. Requires JWT Bearer.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "3. Dashboard", "description": "**Purpose:** widget-first internal dashboard (summary, charts, map, attention)\n**Prereq:** JWT + 2FA + `dashboard.view`\n**Playbook:** `docs/api/dashboard/README.md`", "item": [ { "name": "01. Dashboard KPI summary", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "summary" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d) on event occurred_at. With date_to omitted pair → default last 30 days.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes (prefer L2); intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "KPI cards for the internal dashboard (events, threshold, impacts, drafts, reports, published). Hard-filtered by org_scope. Shared filters optional; default date window = last 30 days when both date_from/date_to omitted. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "summary" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d) on event occurred_at. With date_to omitted pair → default last 30 days.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes (prefer L2); intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "KPI cards for the internal dashboard (events, threshold, impacts, drafts, reports, published). Hard-filtered by org_scope. Shared filters optional; default date window = last 30 days when both date_from/date_to omitted. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Dashboard attention feed", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/attention", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "attention" ], "query": [ { "key": "kind", "value": "report_pending", "description": "Repeatable: report_returned | report_pending | event_new | event_threshold | draft_stale.", "disabled": true }, { "key": "start", "value": "0", "description": "Pagination offset.", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Operational “perlu perhatian” feed (report_returned, report_pending, event_new, event_threshold, draft_stale). Optional kind[] filter and start/length pagination plus shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/attention", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "attention" ], "query": [ { "key": "kind", "value": "report_pending", "description": "Repeatable: report_returned | report_pending | event_new | event_threshold | draft_stale.", "disabled": true }, { "key": "start", "value": "0", "description": "Pagination offset.", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Operational “perlu perhatian” feed (report_returned, report_pending, event_new, event_threshold, draft_stale). Optional kind[] filter and start/length pagination plus shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Dashboard trends chart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/trends", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "trends" ], "query": [ { "key": "period", "value": "monthly", "description": "daily | weekly | monthly (default monthly).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Time-series event counts. Query period=daily|weekly|monthly (default monthly) plus shared dashboard filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/trends", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "trends" ], "query": [ { "key": "period", "value": "monthly", "description": "daily | weekly | monthly (default monthly).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Time-series event counts. Query period=daily|weekly|monthly (default monthly) plus shared dashboard filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Dashboard types chart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "types" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Distribution of events by disaster type under org_scope and shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "types" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Distribution of events by disaster type under org_scope and shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Dashboard regions chart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "regions" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Geographic distribution with adaptive grain (province scope → kab/kota L2; single L2 → kecamatan L3). Shared filters apply. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "regions" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Geographic distribution with adaptive grain (province scope → kab/kota L2; single L2 → kecamatan L3). Shared filters apply. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Dashboard pipeline chart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/pipeline", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "pipeline" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Operational funnel buckets (event status + report siblings) under org_scope and shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/charts/pipeline", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "charts", "pipeline" ], "query": [ { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Operational funnel buckets (event status + report siblings) under org_scope and shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. Dashboard map events", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/map/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "map", "events" ], "query": [ { "key": "bbox", "value": "107.5,-7.0,107.8,-6.8", "description": "minLng,minLat,maxLng,maxLat viewport filter.", "disabled": true }, { "key": "limit", "value": "500", "description": "Max markers (default 500, max 1000).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Event markers for map/cluster UI. Optional bbox=minLng,minLat,maxLng,maxLat and limit (default 500, max 1000) plus shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/dashboard/map/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "dashboard", "map", "events" ], "query": [ { "key": "bbox", "value": "107.5,-7.0,107.8,-6.8", "description": "minLng,minLat,maxLng,maxLat viewport filter.", "disabled": true }, { "key": "limit", "value": "500", "description": "Max markers (default 500, max 1000).", "disabled": true }, { "key": "date_from", "value": "2026-07-13", "description": "Inclusive start date (Y-m-d). Default last 30 days if both dates omitted.", "disabled": true }, { "key": "date_to", "value": "2026-08-12", "description": "Inclusive end date (Y-m-d).", "disabled": true }, { "key": "disaster_type_id", "value": "019f4602-ef3b-73bd-9ad1-eb92d1947bde", "description": "Repeatable disaster type UUID filter.", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "kebencanaan | damkar.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Repeatable region codes; intersected with org_scope.", "disabled": true }, { "key": "threshold", "value": "false", "description": "When true/1, only threshold-eligible events.", "disabled": true } ], "variable": [] }, "description": "Event markers for map/cluster UI. Optional bbox=minLng,minLat,maxLng,maxLat and limit (default 500, max 1000) plus shared filters. Playbook: docs/api/dashboard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "4. RBAC, Menu, User", "description": "**Purpose:** menu gating, roles/permissions, user CRUD\n**Prereq:** JWT + 2FA + RBAC permissions\n**Playbook:** `docs/api/rbac/README.md`", "item": [ { "name": "4.1 Role & Menu", "description": "**Purpose:** `GET /app/me/menu`, roles CRUD, sync permissions, assign/remove users\n**Prereq:** `roles.*` / menu permissions\n**Playbook:** `docs/api/rbac/README.md`", "item": [ { "name": "01. List Menu", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/me/menu", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "me", "menu" ], "query": [], "variable": [] }, "description": "Return a list of Menu. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/me/menu", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "me", "menu" ], "query": [], "variable": [] }, "description": "Return a list of Menu. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List Role", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles" ], "query": [], "variable": [] }, "description": "Return a list of Role. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles" ], "query": [], "variable": [] }, "description": "Return a list of Role. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Create Role", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles" ], "query": [], "variable": [] }, "description": "Create a new Role from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"is_active\": true,\n \"is_system\": true,\n \"is_default\": true,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles" ], "query": [], "variable": [] }, "description": "Create a new Role from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"is_active\": true,\n \"is_system\": true,\n \"is_default\": true,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get Role detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Return one Role by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Return one Role by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Sync role permissions", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role/permissions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role", "permissions" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Sync permissions associated with a role. Replaces all existing permission assignments with the new ones.", "body": { "mode": "raw", "raw": "{\n \"permissions\": [\n \"dashboard.view\",\n \"profile.view\"\n ],\n \"permissions.*\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role/permissions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role", "permissions" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Sync permissions associated with a role. Replaces all existing permission assignments with the new ones.", "body": { "mode": "raw", "raw": "{\n \"permissions\": [\n \"dashboard.view\",\n \"profile.view\"\n ],\n \"permissions.*\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Update Role", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Role, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"is_active\": true,\n \"is_default\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Role, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"is_active\": true,\n \"is_default\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. Delete Role", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Role. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Role. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "08. Remove role from user", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role/users/:user", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role", "users", ":user" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" }, { "key": "user", "value": "", "description": "Path parameter" } ] }, "description": "Remove a role assignment from a user. Detaches the role from the user.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/roles/:role/users/:user", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "roles", ":role", "users", ":user" ], "query": [], "variable": [ { "key": "role", "value": "", "description": "Path parameter" }, { "key": "user", "value": "", "description": "Path parameter" } ] }, "description": "Remove a role assignment from a user. Detaches the role from the user.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "4.2 User", "description": "**Purpose:** internal user list/create/update/delete\n**Prereq:** `users.view` (+ create/update/delete as needed)\n**Playbook:** `docs/api/rbac/README.md`", "item": [ { "name": "01. List User", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users" ], "query": [], "variable": [] }, "description": "List internal users with start/length pagination and optional search, role, is_active, org_scope filters. Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users" ], "query": [], "variable": [] }, "description": "List internal users with start/length pagination and optional search, role, is_active, org_scope filters. Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create User", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users" ], "query": [], "variable": [] }, "description": "Create internal user and assign initial role (`role_id`). Optional `opd_id`: omit or null → backend sets master_opds BPBD (`code=BPBD`); valid UUID stored as-is. `org_scope` codes from GET /app/master/regions?level=2&parent_code=32. Guide: docs/api/rbac/README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Operator Bandung\",\n \"email\": \"operator.bdg@example.com\",\n \"password\": \"StrongPassword123\",\n \"password_confirmation\": \"StrongPassword123\",\n \"role_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"phone\": \"081234567890\",\n \"address\": \"Bandung\",\n \"org_scope\": [\n \"32.73\"\n ],\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users" ], "query": [], "variable": [] }, "description": "Create internal user and assign initial role (`role_id`). Optional `opd_id`: omit or null → backend sets master_opds BPBD (`code=BPBD`); valid UUID stored as-is. `org_scope` codes from GET /app/master/regions?level=2&parent_code=32. Guide: docs/api/rbac/README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Operator Bandung\",\n \"email\": \"operator.bdg@example.com\",\n \"password\": \"StrongPassword123\",\n \"password_confirmation\": \"StrongPassword123\",\n \"role_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"phone\": \"081234567890\",\n \"address\": \"Bandung\",\n \"org_scope\": [\n \"32.73\"\n ],\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get User detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Get internal user detail including roles and permissions. Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Get internal user detail including roles and permissions. Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Update User", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update user profile/status/role/org_scope/opd_id. Sending `opd_id: null` sets BPBD (does not clear). Omit `opd_id` leaves existing value. Guide: docs/api/rbac/README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Operator Bandung Updated\",\n \"org_scope\": [\n \"32.73\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update user profile/status/role/org_scope/opd_id. Sending `opd_id: null` sets BPBD (does not clear). Omit `opd_id` leaves existing value. Guide: docs/api/rbac/README.md.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Operator Bandung Updated\",\n \"org_scope\": [\n \"32.73\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Delete User", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Soft-delete internal user (not self; not last super_admin). Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Soft-delete internal user (not self; not last super_admin). Guide: docs/api/rbac/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Assign role to user", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:user/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":user", "roles" ], "query": [], "variable": [ { "key": "user", "value": "", "description": "Path parameter" } ] }, "description": "Assign a role to a user. Associates the user with the specified role.", "body": { "mode": "raw", "raw": "{\n \"role_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/users/:user/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "users", ":user", "roles" ], "query": [], "variable": [ { "key": "user", "value": "", "description": "Path parameter" } ] }, "description": "Assign a role to a user. Associates the user with the specified role.", "body": { "mode": "raw", "raw": "{\n \"role_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "5. Master Data", "description": "**Purpose:** regions cascade + disaster types/names admin + wizard taxonomy dropdowns\n**Prereq:** JWT + 2FA; `events.view` or `master.view`\n**Note:** all under `/api/v1/app/master/*` (not public)\n**Playbook:** `docs/api/disaster-input/README.md` Step 0, `docs/api/master/README.md`", "item": [ { "name": "5.1 Regions", "description": "**Purpose:** region tree cascade for wizard location pickers\n**Flow:** kab/kota (level=2,parent=32) → kecamatan → desa\n**Vars:** pick `district_code`, `subdistrict_code`, `village_code` from responses\n**Playbook:** `docs/api/disaster-input/README.md` Step 0", "item": [ { "name": "01. List West Java kab/kota (level=2)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions?level=2&parent_code=32&start=0&length=100", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "2", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": false }, { "key": "parent_code", "value": "32", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": false }, { "key": "start", "value": "0", "description": "", "disabled": false }, { "key": "length", "value": "100", "description": "", "disabled": false } ], "variable": [] }, "description": "Cascade step 1: list kabupaten/kota under Jawa Barat (`parent_code=32`).\nPick a row `code` → set env `district_code`.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "2", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": true }, { "key": "parent_code", "value": "32", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": true } ], "variable": [] }, "description": "Wilayah BPS untuk tree Kab/Kota → Kecamatan → Desa. Filter dengan level (1–4) dan parent_code. Wizard Step 0–2. Requires JWT + events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"code\": \"32.04\",\n \"name\": \"Kabupaten Bandung\",\n \"level\": 2,\n \"parent_code\": \"32\"\n }\n ],\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List kecamatan (level=3)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions?level=3&parent_code=%7B%7Bdistrict_code%7D%7D&start=0&length=100", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "3", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": false }, { "key": "parent_code", "value": "{{district_code}}", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": false }, { "key": "start", "value": "0", "description": "", "disabled": false }, { "key": "length", "value": "100", "description": "", "disabled": false } ], "variable": [] }, "description": "Cascade step 2: list kecamatan under `{{district_code}}`.\nPick a row `code` → set env `subdistrict_code`.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "2", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": true }, { "key": "parent_code", "value": "32", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": true } ], "variable": [] }, "description": "Wilayah BPS untuk tree Kab/Kota → Kecamatan → Desa. Filter dengan level (1–4) dan parent_code. Wizard Step 0–2. Requires JWT + events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"code\": \"32.04\",\n \"name\": \"Kabupaten Bandung\",\n \"level\": 2,\n \"parent_code\": \"32\"\n }\n ],\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. List desa/kelurahan (level=4)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions?level=4&parent_code=%7B%7Bsubdistrict_code%7D%7D&start=0&length=100", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "4", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": false }, { "key": "parent_code", "value": "{{subdistrict_code}}", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": false }, { "key": "start", "value": "0", "description": "", "disabled": false }, { "key": "length", "value": "100", "description": "", "disabled": false } ], "variable": [] }, "description": "Cascade step 3: list desa/kelurahan under `{{subdistrict_code}}`.\nPick a row `code` → set env `village_code` (use as impact `region_code`).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions" ], "query": [ { "key": "level", "value": "2", "description": "Region hierarchy level: 1=provinsi, 2=kab/kota, 3=kecamatan, 4=desa.", "disabled": true }, { "key": "parent_code", "value": "32", "description": "Parent region code (max 13). Example: parent_code=32 with level=2 returns kabupaten under Jawa Barat.", "disabled": true } ], "variable": [] }, "description": "Wilayah BPS untuk tree Kab/Kota → Kecamatan → Desa. Filter dengan level (1–4) dan parent_code. Wizard Step 0–2. Requires JWT + events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"code\": \"32.04\",\n \"name\": \"Kabupaten Bandung\",\n \"level\": 2,\n \"parent_code\": \"32\"\n }\n ],\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get region by code", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions/:code", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions", ":code" ], "query": [], "variable": [ { "key": "code", "value": "32.04", "description": "Path parameter" } ] }, "description": "Detail satu wilayah by BPS code (e.g. 32.04). Requires JWT + events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/regions/:code", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "regions", ":code" ], "query": [], "variable": [ { "key": "code", "value": "32.04", "description": "Path parameter" } ] }, "description": "Detail satu wilayah by BPS code (e.g. 32.04). Requires JWT + events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.2 Disaster Types", "description": "**Purpose:** admin CRUD + list for Jenis Kejadian (`type_group`, `report_category`)\n**Vars:** capture `disaster_type_id` for event create\n**Playbook:** `docs/api/master/README.md`", "item": [ { "name": "01. List disaster types (admin)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Search across code, name, description, report_category.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag. Defaults to true when omitted (pass false or 0 to include inactive).", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "Filter by Jenis Laporan: kebencanaan or damkar.", "disabled": true }, { "key": "type_group", "value": "bencana_alam", "description": "Filter by sub-group. kebencanaan -> bencana_alam/non_alam/sosial; damkar -> damkar.", "disabled": true } ], "variable": [] }, "description": "Paginated admin list of master_disaster_types. Filters: report_category, type_group, is_active (defaults to true when omitted), search on code/name/description. Each item includes type_group. Requires JWT Bearer + master.view. See docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Search across code, name, description, report_category.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag. Defaults to true when omitted (pass false or 0 to include inactive).", "disabled": true }, { "key": "report_category", "value": "kebencanaan", "description": "Filter by Jenis Laporan: kebencanaan or damkar.", "disabled": true }, { "key": "type_group", "value": "bencana_alam", "description": "Filter by sub-group. kebencanaan -> bencana_alam/non_alam/sosial; damkar -> damkar.", "disabled": true } ], "variable": [] }, "description": "Paginated admin list of master_disaster_types. Filters: report_category, type_group, is_active (defaults to true when omitted), search on code/name/description. Each item includes type_group. Requires JWT Bearer + master.view. See docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get Disaster Type detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Disaster Type by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Disaster Type by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Update Disaster Type", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Disaster Type, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": 0,\n \"report_category\": \"kebencanaan\",\n \"type_group\": \"bencana_alam\",\n \"name\": \"\",\n \"description\": \"\",\n \"icon_key\": \"\",\n \"sort_order\": 0,\n \"effective_from\": \"\",\n \"effective_to\": \"\",\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Disaster Type, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": 0,\n \"report_category\": \"kebencanaan\",\n \"type_group\": \"bencana_alam\",\n \"name\": \"\",\n \"description\": \"\",\n \"icon_key\": \"\",\n \"sort_order\": 0,\n \"effective_from\": \"\",\n \"effective_to\": \"\",\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Delete Disaster Type", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Disaster Type. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Disaster Type. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.3 Disaster Names", "description": "**Purpose:** admin CRUD + list for Penyebab Kejadian\n**Query:** filter by `disaster_type_id`\n**Vars:** capture `disaster_name_id`\n**Playbook:** `docs/api/master/README.md`", "item": [ { "name": "01. List disaster names (admin)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Bandang", "description": "Search across name and description.", "disabled": true }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Filter names belonging to a master_disaster_types.id.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag. Defaults to true when omitted (pass false or 0 to include inactive).", "disabled": true } ], "variable": [] }, "description": "Paginated admin list of master_disaster_names (UI: Penyebab Kejadian). Filter by disaster_type_id and is_active (defaults to true when omitted). Requires JWT Bearer + master.view. See docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Bandang", "description": "Search across name and description.", "disabled": true }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Filter names belonging to a master_disaster_types.id.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag. Defaults to true when omitted (pass false or 0 to include inactive).", "disabled": true } ], "variable": [] }, "description": "Paginated admin list of master_disaster_names (UI: Penyebab Kejadian). Filter by disaster_type_id and is_active (defaults to true when omitted). Requires JWT Bearer + master.view. See docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get Disaster Name detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Disaster Name by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Disaster Name by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Update Disaster Name", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Disaster Name, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"name\": \"\",\n \"description\": \"\",\n \"sort_order\": 0,\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Disaster Name, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"name\": \"\",\n \"description\": \"\",\n \"sort_order\": 0,\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Delete Disaster Name", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Disaster Name. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/disaster-names/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "disaster-names", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Disaster Name. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.4 Disaster Input Taxonomy", "description": "**Purpose:** wizard dropdowns — prefer `GET /app/master/wizard-dropdowns` (1 call), fallback per-resource GETs\n**Also:** admin CRUD for damage-types hierarchy (lazy tree)\n**Prereq:** JWT + `events.view` (wizard) / `master.*` (CRUD)\n**Playbook:** `docs/api/disaster-input/README.md` §Wizard at a glance", "item": [ { "name": "01. Bootstrap wizard dropdowns (Step 2+3 masters)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/wizard-dropdowns", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "wizard-dropdowns" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/wizard-dropdowns", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "wizard-dropdowns" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List casualty types (Korban)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/casualty-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "casualty-types" ], "query": [], "variable": [] }, "description": "Step 2 korban categories: menderita, mengungsi, terancam, meninggal, hilang.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/casualty-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "casualty-types" ], "query": [], "variable": [] }, "description": "Step 2 korban categories: menderita, mengungsi, terancam, meninggal, hilang.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. List need types (Kebutuhan)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/need-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "need-types" ], "query": [], "variable": [] }, "description": "Step 2 kebutuhan multi-row (e.g. Pangan, Air bersih).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/need-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "need-types" ], "query": [], "variable": [] }, "description": "Step 2 kebutuhan multi-row (e.g. Pangan, Air bersih).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. List damage levels (Tingkat rusak)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-levels", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-levels" ], "query": [], "variable": [] }, "description": "Step 2/infra levels: rusak_ringan, rusak_sedang, rusak_berat.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-levels", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-levels" ], "query": [], "variable": [] }, "description": "Step 2/infra levels: rusak_ringan, rusak_sedang, rusak_berat.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. List infrastructure types", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/infrastructure-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "infrastructure-types" ], "query": [], "variable": [] }, "description": "Step 2 optional infrastructure type reference (Jalan, Jembatan, …).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/infrastructure-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "infrastructure-types" ], "query": [], "variable": [] }, "description": "Step 2 optional infrastructure type reference (Jalan, Jembatan, …).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. List units (Satuan)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/units", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "units" ], "query": [], "variable": [] }, "description": "Satuan for needs/aid: jiwa, kk, liter, ha, unit.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/units", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "units" ], "query": [], "variable": [] }, "description": "Satuan for needs/aid: jiwa, kk, liter, ha, unit.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. List agencies (Instansi)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "agencies" ], "query": [], "variable": [] }, "description": "Step 3 instansi terlibat (bpbd, tni, polri, pmi).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "agencies" ], "query": [], "variable": [] }, "description": "Step 3 instansi terlibat (bpbd, tni, polri, pmi).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "08. List equipment (Peralatan)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/equipment", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "equipment" ], "query": [], "variable": [] }, "description": "Step 3 checklist peralatan (genset, perahu, tenda, alat_berat).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/equipment", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "equipment" ], "query": [], "variable": [] }, "description": "Step 3 checklist peralatan (genset, perahu, tenda, alat_berat).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "09. List logistic items", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/logistics", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "logistics" ], "query": [], "variable": [] }, "description": "Optional Step 3 aid item reference (Beras, Air mineral, …).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/logistics", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "logistics" ], "query": [], "variable": [] }, "description": "Optional Step 3 aid item reference (Beras, Air mineral, …).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "10. List/manage damage types (hierarchy)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types" ], "query": [ { "key": "parent_id", "value": "", "description": "Lazy tree: omit/empty = roots; UUID = direct children. Ignored for wizard is_end_data=1 without parent_id.", "disabled": true }, { "key": "is_end_data", "value": "true", "description": "true/1 = selectable leaves (wizard Select2; data is a flat array).", "disabled": true }, { "key": "search", "value": "Rumah", "description": "Case-insensitive name/category contains; flat list across the tree.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Default true for list.", "disabled": true }, { "key": "start", "value": "0", "description": "Offset for admin paginated list.", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100). Wizard end-data defaults to 100.", "disabled": true } ], "variable": [] }, "description": "Admin lazy tree: parent_id (omit/empty=roots). Wizard Select2: is_end_data=1 returns flat leaves in data[]. Search= flat. CRUD POST/PATCH/DELETE with delete guards (children, damage_records) and PATCH recap-sensitive name/category block. Excel category-matching Phase 2.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types" ], "query": [ { "key": "parent_id", "value": "", "description": "Lazy tree: omit/empty = roots; UUID = direct children. Ignored for wizard is_end_data=1 without parent_id.", "disabled": true }, { "key": "is_end_data", "value": "true", "description": "true/1 = selectable leaves (wizard Select2; data is a flat array).", "disabled": true }, { "key": "search", "value": "Rumah", "description": "Case-insensitive name/category contains; flat list across the tree.", "disabled": true }, { "key": "is_active", "value": "true", "description": "Default true for list.", "disabled": true }, { "key": "start", "value": "0", "description": "Offset for admin paginated list.", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100). Wizard end-data defaults to 100.", "disabled": true } ], "variable": [] }, "description": "Admin lazy tree: parent_id (omit/empty=roots). Wizard Select2: is_end_data=1 returns flat leaves in data[]. Search= flat. CRUD POST/PATCH/DELETE with delete guards (children, damage_records) and PATCH recap-sensitive name/category block. Excel category-matching Phase 2.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "11. Get Damage Type detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Damage Type by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Damage Type by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "12. Update Damage Type", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Damage Type, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"parent_id\": 0,\n \"category\": \"\",\n \"description\": \"\",\n \"is_end_data\": true,\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Damage Type, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"parent_id\": 0,\n \"category\": \"\",\n \"description\": \"\",\n \"is_end_data\": true,\n \"is_active\": true,\n \"version\": 0,\n \"correlation_id\": -6.90389\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "13. Delete Damage Type", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Damage Type. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/damage-types/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "damage-types", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Damage Type. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.5 Evacuation Points", "description": "**Purpose:** master titik evakuasi CRUD + recap per kab/kota\n**Create:** single object or `{ items: [...] }` (max 100, all-or-nothing)\n**Unique:** `(region_code, lat/lng)`; org_scope enforced\n**Playbook:** `docs/api/master/README.md`", "item": [ { "name": "01. List evacuation points (safe routes)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Gasibu", "description": "Search description and region_code.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Filter by exact region_code or descendants (prefix match).", "disabled": true } ], "variable": [] }, "description": "Paginated master_evacuation_points. Filters: search, region_code (prefix). Results limited by org_scope. Guide: docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Gasibu", "description": "Search description and region_code.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Filter by exact region_code or descendants (prefix match).", "disabled": true } ], "variable": [] }, "description": "Paginated master_evacuation_points. Filters: search, region_code (prefix). Results limited by org_scope. Guide: docs/api/master/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Evacuation Point", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points" ], "query": [], "variable": [] }, "description": "Create a new Evacuation Point from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"items\": [\n null\n ],\n \"items.*.region_code\": \"32.04.01.2001\",\n \"items.*.description\": \"\",\n \"items.*.lat\": -6.90389,\n \"items.*.lng\": 107.61861,\n \"items.*.area_m2\": 0,\n \"items.*.capacity\": 120\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points" ], "query": [], "variable": [] }, "description": "Create a new Evacuation Point from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"items\": [\n null\n ],\n \"items.*.region_code\": \"32.04.01.2001\",\n \"items.*.description\": \"\",\n \"items.*.lat\": -6.90389,\n \"items.*.lng\": 107.61861,\n \"items.*.area_m2\": 0,\n \"items.*.capacity\": 120\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. RecapByRegency By Regency", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/recap/by-regency", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", "recap", "by-regency" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/recap/by-regency", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", "recap", "by-regency" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Get Evacuation Point detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Evacuation Point by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Evacuation Point by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Update Evacuation Point", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Evacuation Point, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"32.04.01.2001\",\n \"description\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"area_m2\": 0,\n \"capacity\": 120\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Evacuation Point, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"32.04.01.2001\",\n \"description\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"area_m2\": 0,\n \"capacity\": 120\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Delete Evacuation Point", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Evacuation Point. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/evacuation-points/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "evacuation-points", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Evacuation Point. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.6 Call Centers", "description": "**Purpose:** master call-center CRUD (kab/kota + province 32); WhatsApp + phone\n**Create:** single object or `{ items: [...] }` (max 100); `contact_type` + `phone_number`; numbers not unique\n**Playbook:** `docs/api/master/README.md` §4", "item": [ { "name": "01. List call centers", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Bandung", "description": "Search name, phone_number, region_code, message_template, contact_type.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Exact region_code filter (kab/kota or province 32).", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag.", "disabled": true } ], "variable": [] }, "description": "Paginated master_call_centers. Filters: search, region_code, is_active. Results limited by org_scope (province 32 included for Jabar scopes). Guide: docs/api/master/README.md §4.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers" ], "query": [ { "key": "start", "value": "0", "description": "Offset for pagination (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Page size / limit (default 20, max 100).", "disabled": true }, { "key": "search", "value": "Bandung", "description": "Search name, phone_number, region_code, message_template, contact_type.", "disabled": true }, { "key": "region_code", "value": "32.73", "description": "Exact region_code filter (kab/kota or province 32).", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter by active flag.", "disabled": true } ], "variable": [] }, "description": "Paginated master_call_centers. Filters: search, region_code, is_active. Results limited by org_scope (province 32 included for Jabar scopes). Guide: docs/api/master/README.md §4.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Call Center", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers" ], "query": [], "variable": [] }, "description": "Create a new Call Center from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"items\": [\n null\n ],\n \"items.*.region_code\": \"32.04.01.2001\",\n \"items.*.name\": \"\",\n \"items.*.contact_type\": \"+62-811-2233-4455\",\n \"items.*.phone_number\": \"+1234567890\",\n \"items.*.message_template\": -6.90389,\n \"items.*.sort_order\": 0,\n \"items.*.is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers" ], "query": [], "variable": [] }, "description": "Create a new Call Center from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"items\": [\n null\n ],\n \"items.*.region_code\": \"32.04.01.2001\",\n \"items.*.name\": \"\",\n \"items.*.contact_type\": \"+62-811-2233-4455\",\n \"items.*.phone_number\": \"+1234567890\",\n \"items.*.message_template\": -6.90389,\n \"items.*.sort_order\": 0,\n \"items.*.is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get Call Center detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Call Center by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Call Center by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Update Call Center", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Call Center, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"32.04.01.2001\",\n \"name\": \"\",\n \"contact_type\": \"+62-811-2233-4455\",\n \"phone_number\": \"+1234567890\",\n \"message_template\": -6.90389,\n \"sort_order\": 0,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Call Center, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"32.04.01.2001\",\n \"name\": \"\",\n \"contact_type\": \"+62-811-2233-4455\",\n \"phone_number\": \"+1234567890\",\n \"message_template\": -6.90389,\n \"sort_order\": 0,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Delete Call Center", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Call Center. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/call-centers/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "call-centers", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Call Center. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.7 Volunteer Clusters", "description": "**Purpose:** internal volunteer cluster master data CRUD\n**Endpoints:** `/app/master/volunteer-clusters`\n**Prereq:** JWT + 2FA + `master.view`/`create`/`update`/`delete` permissions", "item": [ { "name": "01. App / List Master Volunteer Clusters", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters" ], "query": [ { "key": "start", "value": "0", "description": "Starting offset (0-indexed)", "disabled": true }, { "key": "length", "value": "20", "description": "Items per page (max 100)", "disabled": true }, { "key": "search", "value": "pertolongan", "description": "Search by cluster name or code", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter active status (true/false)", "disabled": true } ], "variable": [] }, "description": "Retrieve paginated master list of volunteer clusters. Requires JWT and master.view or volunteers.view permission.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters" ], "query": [ { "key": "start", "value": "0", "description": "Starting offset (0-indexed)", "disabled": true }, { "key": "length", "value": "20", "description": "Items per page (max 100)", "disabled": true }, { "key": "search", "value": "pertolongan", "description": "Search by cluster name or code", "disabled": true }, { "key": "is_active", "value": "true", "description": "Filter active status (true/false)", "disabled": true } ], "variable": [] }, "description": "Retrieve paginated master list of volunteer clusters. Requires JWT and master.view or volunteers.view permission.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. App / Create Master Volunteer Cluster", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters" ], "query": [], "variable": [] }, "description": "Create a new master volunteer cluster. Requires master.create permission.", "body": { "mode": "raw", "raw": "{\n \"code\": \"dapur_umum\",\n \"name\": \"Dapur Umum\",\n \"description\": \"Klaster penyiapan dan pendistribusian makanan siap saji bagi pengungsi\",\n \"sort_order\": 30,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters" ], "query": [], "variable": [] }, "description": "Create a new master volunteer cluster. Requires master.create permission.", "body": { "mode": "raw", "raw": "{\n \"code\": \"dapur_umum\",\n \"name\": \"Dapur Umum\",\n \"description\": \"Klaster penyiapan dan pendistribusian makanan siap saji bagi pengungsi\",\n \"sort_order\": 30,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. App / Show Master Volunteer Cluster Details", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Get single master volunteer cluster details by ID.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Get single master volunteer cluster details by ID.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. App / Update Master Volunteer Cluster", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update master volunteer cluster attributes. Requires master.update permission.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Pertolongan & Penyelamatan (SAR)\",\n \"description\": \"Pencarian, pertolongan, dan penyelamatan darurat\",\n \"sort_order\": 10,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update master volunteer cluster attributes. Requires master.update permission.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Pertolongan & Penyelamatan (SAR)\",\n \"description\": \"Pencarian, pertolongan, dan penyelamatan darurat\",\n \"sort_order\": 10,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. App / Update Master Volunteer Cluster", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update master volunteer cluster attributes. Requires master.update permission.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Pertolongan & Penyelamatan (SAR)\",\n \"description\": \"Pencarian, pertolongan, dan penyelamatan darurat\",\n \"sort_order\": 10,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update master volunteer cluster attributes. Requires master.update permission.", "body": { "mode": "raw", "raw": "{\n \"name\": \"Pertolongan & Penyelamatan (SAR)\",\n \"description\": \"Pencarian, pertolongan, dan penyelamatan darurat\",\n \"sort_order\": 10,\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. App / Delete Master Volunteer Cluster", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Soft delete master volunteer cluster. Requires master.delete permission.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/volunteer-clusters/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "volunteer-clusters", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Soft delete master volunteer cluster. Requires master.delete permission.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "5.8 Water Distribution Agencies", "description": "**Purpose:** admin CRUD shared `master_agencies` (water distribution + Step 3)\n**Endpoints:** `/app/master/water-distribution-agencies`\n**Note:** list/show include `usage` + `is_deletable`; DELETE blocked when referenced\n**Taxonomy:** wizard still uses `GET /app/master/agencies`\n**Playbook:** `docs/api/master/README.md` §5", "item": [ { "name": "01. List Water Distribution Agency", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies" ], "query": [], "variable": [] }, "description": "Return a list of Water Distribution Agency. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies" ], "query": [], "variable": [] }, "description": "Return a list of Water Distribution Agency. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Water Distribution Agency", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies" ], "query": [], "variable": [] }, "description": "Create a new Water Distribution Agency from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies" ], "query": [], "variable": [] }, "description": "Create a new Water Distribution Agency from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Get Water Distribution Agency detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Water Distribution Agency by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Water Distribution Agency by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Update Water Distribution Agency", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Water Distribution Agency, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Water Distribution Agency, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"name\": \"\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Delete Water Distribution Agency", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Water Distribution Agency. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/master/water-distribution-agencies/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "master", "water-distribution-agencies", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Water Distribution Agency. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "6. Disaster Data", "description": "**Purpose:** end-to-end disaster lifecycle after master data is loaded\n**Flow:** input → upload files → submit report → approval → publication\n**Playbook:** `docs/api/disaster-input/README.md`", "item": [ { "name": "6.1 Disaster Input", "description": "**Actor:** operator with `events.*`\n**Flow:** POST create → PUT Step 1 → modular Step 2 (`GET/POST/PUT/DELETE .../impacts`) → PUT Step 3 (`response`) → GET Step 4 review → optional PDF `GET .../export`\n**SK (list action Upload SK):** `GET/POST/DELETE .../events/{id}/sk*` — PDF/DOCX, replace, status-agnostic; not wizard `/app/files`\n**Step 2 primary:** pageable `/impacts` + per-card writes; bulk `wizard_step: 2` + `impacts[]` is secondary full-replace (omit = delete)\n**BREAKING:** GET detail `step_2` is slim (`impacts_count`, `impacts_href`) — no full impacts[]\n**PDF:** `GET /app/events/{id}/export` or `GET /app/events/export?event_id=` → binary PDF (draft OK)\n**Key fields:** `wizard_step`, `version`, singular `response`, `handling_matrix` (6 items), impact `updated_by`, detail `sk_documents`\n**Vars:** `event_id`, `event_version`, `impact_id`, `response_id`, `document_id`, `sk_kind`\n**Playbook:** `docs/api/disaster-input/README.md`, `docs/api/events/laporan-pdf.md`, `docs/api/events/sk-documents.md`", "item": [ { "name": "01. List disaster events", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events" ], "query": [ { "key": "start", "value": "0", "description": "Offset", "disabled": true }, { "key": "length", "value": "20", "description": "Limit max 100", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Free-text search", "disabled": true }, { "key": "status", "value": "draft", "description": "Event status filter", "disabled": true }, { "key": "sort", "value": "-occurred_at", "description": "Sort column; prefix - for desc", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "description": "Inclusive occurred_at lower bound Y-m-d", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "Inclusive occurred_at upper bound Y-m-d", "disabled": true }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "", "disabled": true }, { "key": "disaster_name_id", "value": "c0f89dbb-3470-44dd-b846-1bc6dbcb5f6f", "description": "", "disabled": true }, { "key": "is_highlighted", "value": "1", "description": "0|1", "disabled": true }, { "key": "threshold", "value": "1", "description": "0|1 — filter events meeting official threshold eligibility", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Prefix match on main_region_code", "disabled": true } ], "variable": [] }, "description": "Paginated flat event list with optional filters: date_from/date_to (occurred_at inclusive), disaster_type_id, disaster_name_id, is_highlighted (0|1), main_region_code (prefix match AND org_scope), threshold (0|1 — OR eligibility: meninggal≥1, non-meninggal≥50 jiwa, Rumah+infra≥5, ha≥1, completed sk_tanggap_darurat). Playbook: docs/api/disaster-input/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events" ], "query": [ { "key": "start", "value": "0", "description": "Offset", "disabled": true }, { "key": "length", "value": "20", "description": "Limit max 100", "disabled": true }, { "key": "search", "value": "Banjir", "description": "Free-text search", "disabled": true }, { "key": "status", "value": "draft", "description": "Event status filter", "disabled": true }, { "key": "sort", "value": "-occurred_at", "description": "Sort column; prefix - for desc", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "description": "Inclusive occurred_at lower bound Y-m-d", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "Inclusive occurred_at upper bound Y-m-d", "disabled": true }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "", "disabled": true }, { "key": "disaster_name_id", "value": "c0f89dbb-3470-44dd-b846-1bc6dbcb5f6f", "description": "", "disabled": true }, { "key": "is_highlighted", "value": "1", "description": "0|1", "disabled": true }, { "key": "threshold", "value": "1", "description": "0|1 — filter events meeting official threshold eligibility", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Prefix match on main_region_code", "disabled": true } ], "variable": [] }, "description": "Paginated flat event list with optional filters: date_from/date_to (occurred_at inclusive), disaster_type_id, disaster_name_id, is_highlighted (0|1), main_region_code (prefix match AND org_scope), threshold (0|1 — OR eligibility: meninggal≥1, non-meninggal≥50 jiwa, Rumah+infra≥5, ha≥1, completed sk_tanggap_darurat). Playbook: docs/api/disaster-input/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"\",\n \"occurred_at\": \"17-07-2026 14:30:00\",\n \"percent_complete\": 75,\n \"disaster_type\": {\n \"id\": \"\",\n \"name\": \"Banjir\",\n \"type_group\": \"bencana_alam\"\n }\n }\n ],\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Event", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events" ], "query": [], "variable": [] }, "description": "Create a new Event from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"{{disaster_type_id}}\",\n \"disaster_name_id\": \"{{disaster_name_id}}\",\n \"title\": \"Banjir Bandung Wetan\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"32.04\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events" ], "query": [], "variable": [] }, "description": "Create a new Event from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"{{disaster_type_id}}\",\n \"disaster_name_id\": \"{{disaster_name_id}}\",\n \"title\": \"Banjir Bandung Wetan\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"32.04\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "const eventPayload = payload.event && payload.event.id ? payload.event : payload;", "saveEnv('event_id', eventPayload.id || (payload.step_1 && payload.step_1.identity && payload.step_1.identity.id));", "saveEnv('event_version', eventPayload.version != null ? eventPayload.version : (payload.version != null ? payload.version : (payload.step_1 && payload.step_1.identity && payload.step_1.identity.version)));", "const impacts = (payload.step_2 && Array.isArray(payload.step_2.impacts)) ? payload.step_2.impacts : [];", "if (impacts[0] && impacts[0].id) saveEnv('impact_id', impacts[0].id);", "const responseObj = payload.step_3 && payload.step_3.response ? payload.step_3.response : null;", "if (responseObj && responseObj.id) saveEnv('response_id', responseObj.id);" ] } } ] }, { "name": "03. Get Event detail (Step 4 review; slim step_2)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Return one Event by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Return one Event by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Save Step 1 (identity)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 1,\n \"version\": \"{{event_version}}\",\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"{{disaster_type_id}}\",\n \"disaster_name_id\": \"{{disaster_name_id}}\",\n \"title\": \"Banjir Bandung Wetan (draft)\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"{{district_code}}\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 1,\n \"version\": 1,\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"disaster_name_id\": \"c0f89dbb-3470-44dd-b846-1bc6dbcb5f6f\",\n \"title\": \"Banjir Bandung Wetan (draft)\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"32.04\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "const eventPayload = payload.event && payload.event.id ? payload.event : payload;", "saveEnv('event_id', eventPayload.id || (payload.step_1 && payload.step_1.identity && payload.step_1.identity.id));", "saveEnv('event_version', eventPayload.version != null ? eventPayload.version : (payload.version != null ? payload.version : (payload.step_1 && payload.step_1.identity && payload.step_1.identity.version)));", "const impacts = (payload.step_2 && Array.isArray(payload.step_2.impacts)) ? payload.step_2.impacts : [];", "if (impacts[0] && impacts[0].id) saveEnv('impact_id', impacts[0].id);", "const responseObj = payload.step_3 && payload.step_3.response ? payload.step_3.response : null;", "if (responseObj && responseObj.id) saveEnv('response_id', responseObj.id);" ] } } ] }, { "name": "05. Save Step 2 bulk/legacy (impacts[] full-replace)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "SECONDARY/bulk Step 2. Full-replace: omitted villages are deleted; [] clears all. Response is slim { event } — reload GET .../impacts. Prefer modular POST/PUT /impacts for FE autosave.", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 2,\n \"version\": \"{{event_version}}\",\n \"impacts\": [\n {\n \"region_code\": \"{{village_code}}\",\n \"location_description\": \"RW 05 dekat sungai\",\n \"notes\": \"Prioritas tinggi\",\n \"occurred_time\": \"14:30\",\n \"location\": {\n \"lat\": -6.91,\n \"lng\": 107.62\n },\n \"affected_area_ha\": 2.5,\n \"casualties\": [\n {\n \"casualty_type_id\": \"f23c7f1e-7f5f-4ccd-9d27-8f8bdb3eea4a\",\n \"count\": 12,\n \"kk_count\": 4,\n \"is_complete\": true\n }\n ],\n \"needs\": [\n {\n \"need_type_id\": \"a11a11a1-1111-4111-8111-111111111111\",\n \"quantity\": 100,\n \"unit_id\": \"b22b22b2-2222-4222-8222-222222222222\",\n \"unit_label\": \"liter\"\n }\n ],\n \"damages\": [\n {\n \"damage_type_id\": \"c33c33c3-3333-4333-8333-333333333333\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 5,\n \"unit_id\": \"d44d44d4-4444-4444-8444-444444444444\"\n }\n ],\n \"infrastructure\": [\n {\n \"name\": \"Jalan Desa Sukamaju\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 1,\n \"notes\": \"Putus 50 m\"\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 1,\n \"version\": 1,\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"disaster_name_id\": \"c0f89dbb-3470-44dd-b846-1bc6dbcb5f6f\",\n \"title\": \"Banjir Bandung Wetan (draft)\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"32.04\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "const eventPayload = payload.event && payload.event.id ? payload.event : payload;", "saveEnv('event_id', eventPayload.id || (payload.step_1 && payload.step_1.identity && payload.step_1.identity.id));", "saveEnv('event_version', eventPayload.version != null ? eventPayload.version : (payload.version != null ? payload.version : (payload.step_1 && payload.step_1.identity && payload.step_1.identity.version)));", "const impacts = (payload.step_2 && Array.isArray(payload.step_2.impacts)) ? payload.step_2.impacts : [];", "if (impacts[0] && impacts[0].id) saveEnv('impact_id', impacts[0].id);", "const responseObj = payload.step_3 && payload.step_3.response ? payload.step_3.response : null;", "if (responseObj && responseObj.id) saveEnv('response_id', responseObj.id);" ] } } ] }, { "name": "06. Save Step 3 (response)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 3,\n \"version\": \"{{event_version}}\",\n \"response\": {\n \"status\": \"dalam_penanganan\",\n \"started_at\": \"2026-07-11\",\n \"estimated_end_at\": \"2026-07-15\",\n \"handling_notes\": \"Evakuasi warga RW 05\",\n \"handling_matrix\": {\n \"items\": [\n {\n \"code\": \"kaji_cepat\",\n \"label\": \"Kaji Cepat Dampak Bencana\",\n \"province\": false,\n \"regency\": true\n },\n {\n \"code\": \"status_darurat\",\n \"label\": \"Penentuan Status Darurat\",\n \"province\": false,\n \"regency\": false\n },\n {\n \"code\": \"evakuasi\",\n \"label\": \"Penyelamatan & Evakuasi Korban\",\n \"province\": false,\n \"regency\": true\n },\n {\n \"code\": \"kebutuhan_dasar\",\n \"label\": \"Pemenuhan Kebutuhan Dasar\",\n \"province\": false,\n \"regency\": true\n },\n {\n \"code\": \"kelompok_rentan\",\n \"label\": \"Perlindungan Kelompok Rentan\",\n \"province\": false,\n \"regency\": false\n },\n {\n \"code\": \"pemulihan_sarpras\",\n \"label\": \"Pemulihan Sarana & Prasarana\",\n \"province\": false,\n \"regency\": false\n }\n ]\n }\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"wizard_step\": 1,\n \"version\": 1,\n \"report_category\": \"kebencanaan\",\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"disaster_name_id\": \"c0f89dbb-3470-44dd-b846-1bc6dbcb5f6f\",\n \"title\": \"Banjir Bandung Wetan (draft)\",\n \"occurred_at\": \"2026-07-11T14:30:00+07:00\",\n \"main_region_code\": \"32.04\",\n \"chronology\": \"Hujan deras sejak siang\",\n \"location\": {\n \"lat\": -6.9175,\n \"lng\": 107.6191\n }\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "const eventPayload = payload.event && payload.event.id ? payload.event : payload;", "saveEnv('event_id', eventPayload.id || (payload.step_1 && payload.step_1.identity && payload.step_1.identity.id));", "saveEnv('event_version', eventPayload.version != null ? eventPayload.version : (payload.version != null ? payload.version : (payload.step_1 && payload.step_1.identity && payload.step_1.identity.version)));", "const impacts = (payload.step_2 && Array.isArray(payload.step_2.impacts)) ? payload.step_2.impacts : [];", "if (impacts[0] && impacts[0].id) saveEnv('impact_id', impacts[0].id);", "const responseObj = payload.step_3 && payload.step_3.response ? payload.step_3.response : null;", "if (responseObj && responseObj.id) saveEnv('response_id', responseObj.id);" ] } } ] }, { "name": "07. List impacts (Step 2 DataTable)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts?start=0&length=20&search=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts" ], "query": [ { "key": "start", "value": "0", "description": "", "disabled": false }, { "key": "length", "value": "20", "description": "", "disabled": false }, { "key": "search", "value": "", "description": "", "disabled": false } ], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Primary Step 2 read. Pageable list → data.items + data.pagination. Capture impact id → env impact_id. Event GET detail does not embed full impacts.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Return a list of Impact. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"items\": [],\n \"pagination\": {\n \"start\": 0,\n \"length\": 20,\n \"total\": 0,\n \"current_page\": 1,\n \"last_page\": 1\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "const items = Array.isArray(payload.items) ? payload.items : (Array.isArray(payload) ? payload : []);", "if (items[0] && items[0].id) saveEnv('impact_id', items[0].id);" ] } } ] }, { "name": "08. Create impact card (Step 2)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Primary Step 2 create. Returns { impact, event } slim. Optional water_distributions[] syncs multi-source liters; water_distribution_liters is derived SUM. Set impact_id from data.impact.id; refresh event_version from data.event.version.", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"{{village_code}}\",\n \"location_description\": \"RW 05 dekat sungai\",\n \"notes\": \"Prioritas tinggi\",\n \"occurred_time\": \"14:30\",\n \"location\": {\n \"lat\": -6.91,\n \"lng\": 107.62\n },\n \"affected_area_ha\": 2.5,\n \"casualties\": [\n {\n \"casualty_type_id\": \"f23c7f1e-7f5f-4ccd-9d27-8f8bdb3eea4a\",\n \"count\": 12,\n \"kk_count\": 4,\n \"is_complete\": true\n }\n ],\n \"needs\": [\n {\n \"need_type_id\": \"a11a11a1-1111-4111-8111-111111111111\",\n \"quantity\": 100,\n \"unit_id\": \"b22b22b2-2222-4222-8222-222222222222\",\n \"unit_label\": \"liter\"\n }\n ],\n \"damages\": [\n {\n \"damage_type_id\": \"c33c33c3-3333-4333-8333-333333333333\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 5,\n \"unit_id\": \"d44d44d4-4444-4444-8444-444444444444\"\n }\n ],\n \"infrastructure\": [\n {\n \"name\": \"Jalan Desa Sukamaju\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 1,\n \"notes\": \"Putus 50 m\"\n }\n ],\n \"water_distributions\": [\n {\n \"agency_id\": \"e55e55e5-5555-4555-8555-555555555555\",\n \"agency_name\": \"BPBD\",\n \"quantity_liters\": 1000\n },\n {\n \"agency_id\": \"f66f66f6-6666-4666-8666-666666666666\",\n \"agency_name\": \"PDAM\",\n \"quantity_liters\": 500\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Create a new Impact from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"region_code\": \"32.04.01.2001\",\n \"location_description\": \"RW 05 dekat sungai\",\n \"occurred_time\": \"14:30\",\n \"location\": {\n \"lat\": -6.91,\n \"lng\": 107.62\n },\n \"affected_area_ha\": 2.5,\n \"notes\": \"Prioritas tinggi\",\n \"casualties\": [\n {\n \"casualty_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"count\": 12,\n \"kk_count\": 4,\n \"is_complete\": true\n }\n ],\n \"needs\": [\n {\n \"need_type_id\": \"a11a11a1-1111-4111-8111-111111111111\",\n \"quantity\": 100,\n \"unit_id\": \"b22b22b2-2222-4222-8222-222222222222\",\n \"unit_label\": \"liter\"\n }\n ],\n \"damages\": [\n {\n \"damage_type_id\": \"c33c33c3-3333-4333-8333-333333333333\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 5,\n \"unit_id\": \"d44d44d4-4444-4444-8444-444444444444\"\n }\n ],\n \"infrastructure\": [\n {\n \"name\": \"Jalan Desa Sukamaju\",\n \"damage_level_id\": \"4f22aa0f-8d57-44fd-8f4d-faf9f95a95b2\",\n \"quantity\": 1,\n \"notes\": \"Putus 50 m\"\n }\n ],\n \"water_distributions\": [\n {\n \"agency_id\": \"e55e55e5-5555-4555-8555-555555555555\",\n \"agency_name\": \"BPBD\",\n \"quantity_liters\": 1000\n },\n {\n \"agency_id\": null,\n \"agency_name\": \"BBWS\",\n \"quantity_liters\": 500\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"impact\": {\n \"id\": \"\",\n \"region_code\": \"32.73.01.2001\"\n },\n \"event\": {\n \"id\": \"\",\n \"version\": 3,\n \"draft_saved_at\": \"2026-07-17T14:30:00+07:00\",\n \"percent_complete\": 40,\n \"impacts_count\": 1\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "if (payload.impact && payload.impact.id) saveEnv('impact_id', payload.impact.id);", "if (payload.event && payload.event.id) saveEnv('event_id', payload.event.id);", "if (payload.event && payload.event.version != null) saveEnv('event_version', payload.event.version);" ] } } ] }, { "name": "09. Get Impact detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Return one Impact by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Return one Impact by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "10. Update impact card (Step 2)", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Primary Step 2 update. Nested keys present = sync; omit key = leave children. water_distributions[] id-based sync; derived water_distribution_liters. Returns { impact, event } slim.", "body": { "mode": "raw", "raw": "{\n \"location_description\": \"RW 05 dekat sungai (updated)\",\n \"notes\": \"Update catatan\",\n \"occurred_time\": \"15:00\",\n \"affected_area_ha\": 3,\n \"casualties\": [\n {\n \"casualty_type_id\": \"f23c7f1e-7f5f-4ccd-9d27-8f8bdb3eea4a\",\n \"count\": 15,\n \"kk_count\": 5,\n \"is_complete\": true\n }\n ],\n \"water_distributions\": [\n {\n \"agency_id\": \"e55e55e5-5555-4555-8555-555555555555\",\n \"agency_name\": \"BPBD\",\n \"quantity_liters\": 750\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Impact, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"location_description\": \"RW 05 dekat sungai (updated)\",\n \"occurred_time\": \"15:00\",\n \"location\": {\n \"lat\": -6.91,\n \"lng\": 107.62\n },\n \"affected_area_ha\": 3,\n \"notes\": \"Update catatan\",\n \"casualties\": [\n {\n \"casualty_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"count\": 15,\n \"kk_count\": 5,\n \"is_complete\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"impact\": {\n \"id\": \"\",\n \"region_code\": \"32.73.01.2001\"\n },\n \"event\": {\n \"id\": \"\",\n \"version\": 3,\n \"draft_saved_at\": \"2026-07-17T14:30:00+07:00\",\n \"percent_complete\": 40,\n \"impacts_count\": 1\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "if (payload.impact && payload.impact.id) saveEnv('impact_id', payload.impact.id);", "if (payload.event && payload.event.id) saveEnv('event_id', payload.event.id);", "if (payload.event && payload.event.version != null) saveEnv('event_version', payload.event.version);" ] } } ] }, { "name": "11. Delete Impact", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing Impact. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/impacts/:impactId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "impacts", ":impactId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "impactId", "value": "{{impact_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing Impact. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"impact\": null,\n \"event\": {\n \"id\": \"\",\n \"version\": 3,\n \"draft_saved_at\": \"2026-07-17T14:30:00+07:00\",\n \"percent_complete\": 40,\n \"impacts_count\": 1\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "if (payload.impact && payload.impact.id) saveEnv('impact_id', payload.impact.id);", "if (payload.event && payload.event.id) saveEnv('event_id', payload.event.id);", "if (payload.event && payload.event.version != null) saveEnv('event_version', payload.event.version);" ] } } ] }, { "name": "12. Toggle event attention highlight", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/highlight", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "highlight" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Toggle is_highlighted for attention pin. Requires events.highlight.", "body": { "mode": "raw", "raw": "{\n \"is_highlighted\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/highlight", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "highlight" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Toggle is_highlighted for attention pin. Requires events.highlight.", "body": { "mode": "raw", "raw": "{\n \"is_highlighted\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "13. Delete Event", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing Event. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing Event. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"version\": 2,\n \"step_1\": {\n \"identity\": {\n \"occurred_at\": \"17-07-2026 14:30:00\"\n }\n },\n \"step_2\": {\n \"impacts_count\": 0,\n \"impacts_href\": \"/api/v1/app/events//impacts\"\n },\n \"step_3\": {\n \"response\": null,\n \"percent_complete\": 40\n },\n \"step_4\": {\n \"percent_complete\": 40,\n \"region_recaps\": [],\n \"review\": {}\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "14. Export laporan PDF (independent)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/export?event_id=%7B%7Bevent_id%7D%7D&tanggal=2026-08-11&petugas_jabatan=Petugas%20Jaga&petugas_nip=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "export" ], "query": [ { "key": "event_id", "value": "{{event_id}}", "description": "", "disabled": false }, { "key": "tanggal", "value": "2026-08-11", "description": "", "disabled": false }, { "key": "petugas_jabatan", "value": "Petugas Jaga", "description": "", "disabled": false }, { "key": "petugas_nip", "value": "", "description": "", "disabled": false } ], "variable": [] }, "description": "Stream formal single-event laporan PDF.\nRequires `event_id` + `tanggal`. Optional `petugas_jabatan` (default Petugas Jaga), `petugas_nama` (default auth user name), `petugas_nip` (default empty). Success = binary PDF (not JSON). Playbook: docs/api/events/laporan-pdf.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "export" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "15. Export laporan PDF (from detail)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/export?tanggal=2026-08-11&petugas_jabatan=Petugas%20Jaga&petugas_nip=", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "export" ], "query": [ { "key": "tanggal", "value": "2026-08-11", "description": "", "disabled": false }, { "key": "petugas_jabatan", "value": "Petugas Jaga", "description": "", "disabled": false }, { "key": "petugas_nip", "value": "", "description": "", "disabled": false } ], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Stream formal laporan PDF for `{{event_id}}` path param.\nRequires `tanggal`. Optional petugas fields with server defaults. Draft allowed. Playbook: docs/api/events/laporan-pdf.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "export" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "16. Coordination text (independent)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/coordination-text?event_id=%7B%7Bevent_id%7D%7D", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "coordination-text" ], "query": [ { "key": "event_id", "value": "{{event_id}}", "description": "", "disabled": false } ], "variable": [] }, "description": "Generate WhatsApp-ready coordination report text for one event.\nRequires `event_id`. Success = JSON envelope with `data.text`. Draft allowed. Playbook: docs/api/events/coordination-text.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/coordination-text", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "coordination-text" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "17. Coordination text (from detail)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/coordination-text", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "coordination-text" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Generate coordination text for path event id.\nSame `data.text` as independent route. Playbook: docs/api/events/coordination-text.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/coordination-text", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "coordination-text" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "Upload SK", "description": "**Action:** list Upload SK (internal)\n**Catalog:** GET /app/events/sk-documents (completed only, cross-event)\n**Kinds:** sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan — 1 file each; re-upload = replace\n**MIME:** PDF + DOCX only; status-agnostic; not wizard `/app/files`\n**Flow:** Catalog / List → Presign → PUT MinIO or local Upload → Complete; Delete by kind\n**Vars:** event_id, document_id, sk_kind, file_upload_url, file_mime_type\n**Playbook:** docs/api/events/sk-documents.md", "item": [ { "name": "01. Catalog completed SK (cross-event)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/sk-documents", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "sk-documents" ], "query": [ { "key": "start", "value": "0", "description": "Offset", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100)", "disabled": true }, { "key": "kind", "value": "{{sk_kind}}", "description": "Optional: sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "description": "Inclusive on event occurred_at (Y-m-d)", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "Inclusive on event occurred_at (Y-m-d)", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Region prefix AND org_scope", "disabled": true }, { "key": "search", "value": "tanggap", "description": "Filename and/or event title", "disabled": true } ], "variable": [] }, "description": "Paginated completed SK documents across events with download_url + minimal event. Permission events.view + org_scope. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/sk-documents", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", "sk-documents" ], "query": [ { "key": "start", "value": "0", "description": "Offset (default 0)", "disabled": true }, { "key": "length", "value": "20", "description": "Page size (max 100)", "disabled": true }, { "key": "kind", "value": "sk_transisi_darurat_pemulihan", "description": "sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "description": "Inclusive lower bound on event occurred_at (Y-m-d)", "disabled": true }, { "key": "date_to", "value": "2026-12-31", "description": "Inclusive upper bound on event occurred_at (Y-m-d)", "disabled": true }, { "key": "main_region_code", "value": "32.04", "description": "Region prefix AND org_scope", "disabled": true }, { "key": "search", "value": "tanggap", "description": "Match filename and/or event title", "disabled": true } ], "variable": [] }, "description": "Paginated flat list of completed SK files (one row per document) with download_url and minimal nested event. Filters: kind, date_from/date_to (event occurred_at), main_region_code, search. Permission events.view + org_scope. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. List SK slots (sk_documents)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk" ], "query": [ { "key": "kind", "value": "{{sk_kind}}", "description": "Optional: sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan", "disabled": true } ], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Returns sk_documents for all three kinds (or one when kind is set). Status-agnostic. Permission events.view. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk" ], "query": [ { "key": "kind", "value": "sk_transisi_darurat_pemulihan", "description": "Optional filter: sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan", "disabled": true } ], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Returns sk_documents for the event (all three keys, or one when kind query is set). Status-agnostic. Permission events.view + org_scope. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Presign SK upload (PDF/DOCX)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "presign" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Create pending SK document for kind `sk_siaga_darurat`|`sk_tanggap_darurat`|`sk_transisi_darurat_pemulihan`.\nMIME PDF/DOCX only; re-upload replace happens on complete.\nSets `document_id`, `file_upload_url`, `file_mime_type`, `sk_kind`.\nPlaybook: docs/api/events/sk-documents.md.", "body": { "mode": "raw", "raw": "{\n \"kind\": \"{{sk_kind}}\",\n \"filename\": \"sk-tanggap.pdf\",\n \"mime_type\": \"application/pdf\",\n \"size_bytes\": 204800\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "presign" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Create pending SK document for kind sk_siaga_darurat|sk_tanggap_darurat|sk_transisi_darurat_pemulihan. Re-upload replace happens on complete. MIME PDF/DOCX only. Permission events.update. Playbook: docs/api/events/sk-documents.md.", "body": { "mode": "raw", "raw": "{\n \"kind\": \"sk_tanggap_darurat\",\n \"filename\": \"sk-tanggap.pdf\",\n \"mime_type\": \"application/pdf\",\n \"size_bytes\": 204800\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 200) {", " const json = pm.response.json();", " const data = json.data || {};", " if (data.document_id) {", " pm.collectionVariables.set('document_id', data.document_id);", " pm.environment.set('document_id', data.document_id);", " }", " if (data.upload_url) {", " pm.collectionVariables.set('file_upload_url', data.upload_url);", " pm.environment.set('file_upload_url', data.upload_url);", " }", " const mime = (data.upload_headers && data.upload_headers['Content-Type']) || data.mime_type;", " if (mime) {", " pm.collectionVariables.set('file_mime_type', mime);", " pm.environment.set('file_mime_type', mime);", " }", " try {", " const body = JSON.parse(pm.request.body.raw);", " if (body.kind) {", " pm.collectionVariables.set('sk_kind', body.kind);", " pm.environment.set('sk_kind', body.kind);", " }", " } catch (e) {}", "}" ] } } ] }, { "name": "04. PUT Upload SK to MinIO (presigned)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "{{file_mime_type}}", "type": "text" } ], "body": { "mode": "file", "file": { "src": "" } }, "url": "{{file_upload_url}}", "description": "External MinIO/S3 upload — **not** a BARATA route.\n\n1. Run **Presign SK** first.\n2. Select a PDF/DOCX as the body.\n3. Then run **Complete SK**.\n\nSkip when `storage=local` — use **Upload SK local** instead. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "05. Upload SK local (multipart) — local storage only", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/upload/:documentId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "upload", ":documentId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "documentId", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Local-only binary upload (multipart field `file`, PDF/DOCX). Rejected with FILE_006 when MinIO/S3 is configured — use PUT to upload_url instead. Playbook: docs/api/events/sk-documents.md.", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "PDF or DOCX (max 20MB)" } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/upload/:documentId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "upload", ":documentId" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "documentId", "value": "", "description": "Path parameter" } ] }, "description": "POST binary to local storage for an SK pending document. Disabled with FILE_006 when MinIO/S3 is configured — PUT to upload_url instead. Permission events.update.", "body": { "mode": "raw", "raw": "{\n \"file\": \"(multipart binary — PDF or DOCX, max 20MB)\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Complete SK upload (replace prior slot)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/complete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "complete" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Marks SK upload completed and replaces any previous file for the same kind. Returns sk_documents. Permission events.update. Playbook: docs/api/events/sk-documents.md.", "body": { "mode": "raw", "raw": "{\n \"document_id\": \"{{document_id}}\",\n \"checksum_sha256\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/complete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", "complete" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" } ] }, "description": "Marks SK upload completed and replaces any previous document for the same kind. Returns sk_documents. Permission events.update. Playbook: docs/api/events/sk-documents.md.", "body": { "mode": "raw", "raw": "{\n \"document_id\": \"{{document_id}}\",\n \"checksum_sha256\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. Delete SK slot by kind", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/:kind", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", ":kind" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "kind", "value": "{{sk_kind}}", "description": "sk_siaga_darurat | sk_tanggap_darurat | sk_transisi_darurat_pemulihan" } ] }, "description": "Clears one SK slot (`sk_siaga_darurat`|`sk_tanggap_darurat`|`sk_transisi_darurat_pemulihan`). Status-agnostic. Permission events.update. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/events/:id/sk/:kind", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "events", ":id", "sk", ":kind" ], "query": [], "variable": [ { "key": "id", "value": "{{event_id}}", "description": "Path parameter" }, { "key": "kind", "value": "", "description": "Path parameter" } ] }, "description": "Clears one of sk_siaga_darurat|sk_tanggap_darurat|sk_transisi_darurat_pemulihan. Status-agnostic. Permission events.update. Playbook: docs/api/events/sk-documents.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "6.2 Upload Files", "description": "**Purpose:** wizard attachments via `/app/files` (presign → MinIO PUT or local upload → complete)\n**Prereq:** parent exists (`event_id` / `impact_id` / `response_id`)\n**Vars:** `document_id`, `file_upload_url`, `file_mime_type`\n**Playbook:** `docs/api/files/README.md`, `docs/api/disaster-input/files.md`", "item": [ { "name": "01. Presign Step 1 — Event evidence", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.\n\nSets collection vars: document_id, file_upload_url, file_mime_type from data (for PUT MinIO → Complete).\nPlaybook: docs/api/files/README.md.\n\nWizard mapping and recommended purpose values: docs/api/disaster-input/files.md.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"laporan-awal.pdf\",\n \"mime_type\": \"application/pdf\",\n \"size_bytes\": 204800,\n \"purpose\": \"event_evidence\",\n \"attachable_type\": \"disaster_event\",\n \"attachable_id\": \"{{event_id}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"bukti-dampak.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"size_bytes\": 204800,\n \"purpose\": \"impact_evidence\",\n \"attachable_type\": \"impact_record\",\n \"attachable_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"document_id\": \"\",\n \"storage\": \"s3\",\n \"upload_method\": \"PUT\",\n \"upload_url\": \"https://minio.example/presigned-url\",\n \"upload_headers\": {\n \"Content-Type\": \"image/jpeg\"\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 200) {", " const json = pm.response.json();", " const data = json.data || {};", " if (data.document_id) {", " pm.collectionVariables.set('document_id', data.document_id);", " pm.environment.set('document_id', data.document_id);", " }", " if (data.upload_url) {", " pm.collectionVariables.set('file_upload_url', data.upload_url);", " pm.environment.set('file_upload_url', data.upload_url);", " }", " const mime = (data.upload_headers && data.upload_headers['Content-Type']) || (json.data && json.data.mime_type);", " if (mime) {", " pm.collectionVariables.set('file_mime_type', mime);", " pm.environment.set('file_mime_type', mime);", " } else if (pm.request.body && pm.request.body.raw) {", " try {", " const body = JSON.parse(pm.request.body.raw);", " if (body.mime_type) {", " pm.collectionVariables.set('file_mime_type', body.mime_type);", " pm.environment.set('file_mime_type', body.mime_type);", " }", " } catch (e) {}", " }", "}" ] } } ] }, { "name": "02. Presign Step 2 — Village impact evidence", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.\n\nSets collection vars: document_id, file_upload_url, file_mime_type from data (for PUT MinIO → Complete).\nPlaybook: docs/api/files/README.md.\n\nWizard mapping and recommended purpose values: docs/api/disaster-input/files.md.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"bukti-dampak.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"size_bytes\": 204800,\n \"purpose\": \"impact_evidence\",\n \"attachable_type\": \"impact_record\",\n \"attachable_id\": \"{{impact_id}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"bukti-dampak.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"size_bytes\": 204800,\n \"purpose\": \"impact_evidence\",\n \"attachable_type\": \"impact_record\",\n \"attachable_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"document_id\": \"\",\n \"storage\": \"s3\",\n \"upload_method\": \"PUT\",\n \"upload_url\": \"https://minio.example/presigned-url\",\n \"upload_headers\": {\n \"Content-Type\": \"image/jpeg\"\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 200) {", " const json = pm.response.json();", " const data = json.data || {};", " if (data.document_id) {", " pm.collectionVariables.set('document_id', data.document_id);", " pm.environment.set('document_id', data.document_id);", " }", " if (data.upload_url) {", " pm.collectionVariables.set('file_upload_url', data.upload_url);", " pm.environment.set('file_upload_url', data.upload_url);", " }", " const mime = (data.upload_headers && data.upload_headers['Content-Type']) || (json.data && json.data.mime_type);", " if (mime) {", " pm.collectionVariables.set('file_mime_type', mime);", " pm.environment.set('file_mime_type', mime);", " } else if (pm.request.body && pm.request.body.raw) {", " try {", " const body = JSON.parse(pm.request.body.raw);", " if (body.mime_type) {", " pm.collectionVariables.set('file_mime_type', body.mime_type);", " pm.environment.set('file_mime_type', body.mime_type);", " }", " } catch (e) {}", " }", "}" ] } } ] }, { "name": "03. Presign Step 3 — Response documentation", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.\n\nSets collection vars: document_id, file_upload_url, file_mime_type from data (for PUT MinIO → Complete).\nPlaybook: docs/api/files/README.md.\n\nWizard mapping and recommended purpose values: docs/api/disaster-input/files.md.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"dokumentasi-penanggulangan.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"size_bytes\": 204800,\n \"purpose\": \"response_documentation\",\n \"attachable_type\": \"response_action\",\n \"attachable_id\": \"{{response_id}}\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/presign", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "presign" ], "query": [], "variable": [] }, "description": "Create a pending wizard document after its parent exists, then return document_id, upload_url, storage (s3|local), upload_method (PUT|POST), and upload_headers. Mapping: Step 1 disaster_event + event UUID; Step 2 impact_record + the village impact-card UUID (nested casualty/need/damage/infrastructure rows share this parent); Step 3 response_action + response UUID; Step 4 does not upload. purpose is optional metadata (max 50), not a runtime enum; recommended values are documented in docs/api/disaster-input/files.md. When MinIO/S3 is configured, client MUST PUT binary to upload_url; otherwise POST multipart to /app/files/upload/{id}. MIME jpeg/png/webp/pdf, max 20MB.", "body": { "mode": "raw", "raw": "{\n \"filename\": \"bukti-dampak.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"size_bytes\": 204800,\n \"purpose\": \"impact_evidence\",\n \"attachable_type\": \"impact_record\",\n \"attachable_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"document_id\": \"\",\n \"storage\": \"s3\",\n \"upload_method\": \"PUT\",\n \"upload_url\": \"https://minio.example/presigned-url\",\n \"upload_headers\": {\n \"Content-Type\": \"image/jpeg\"\n }\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 200) {", " const json = pm.response.json();", " const data = json.data || {};", " if (data.document_id) {", " pm.collectionVariables.set('document_id', data.document_id);", " pm.environment.set('document_id', data.document_id);", " }", " if (data.upload_url) {", " pm.collectionVariables.set('file_upload_url', data.upload_url);", " pm.environment.set('file_upload_url', data.upload_url);", " }", " const mime = (data.upload_headers && data.upload_headers['Content-Type']) || (json.data && json.data.mime_type);", " if (mime) {", " pm.collectionVariables.set('file_mime_type', mime);", " pm.environment.set('file_mime_type', mime);", " } else if (pm.request.body && pm.request.body.raw) {", " try {", " const body = JSON.parse(pm.request.body.raw);", " if (body.mime_type) {", " pm.collectionVariables.set('file_mime_type', body.mime_type);", " pm.environment.set('file_mime_type', body.mime_type);", " }", " } catch (e) {}", " }", "}" ] } } ] }, { "name": "04. PUT Upload to MinIO (presigned)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "{{file_mime_type}}", "type": "text" } ], "body": { "mode": "file", "file": { "src": "" } }, "url": "{{file_upload_url}}", "description": "External MinIO/S3 upload — **not** a BARATA route.\n\n1. Run **Presign** first (sets `file_upload_url` + `file_mime_type`).\n2. Select a local binary file as the body.\n3. Content-Type must match `upload_headers` from prescign (usually `mime_type`).\n4. Then run **Complete** with `{{document_id}}`.\n\nSkip this when `storage=local` — use **Upload local (multipart)** instead. Playbook: docs/api/files/README.md.", "auth": { "type": "noauth" } }, "response": [] }, { "name": "05. Upload local (multipart) — local storage only", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/upload/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "upload", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Local-only binary upload (multipart field `file`). Rejected with FILE_006 when MinIO/S3 is configured — use **PUT Upload to MinIO** instead.", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "Binary file (max 20MB)" } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/upload/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "upload", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Local-only binary upload (multipart field file). Rejected with FILE_006 when MinIO/S3 is configured — use PUT to upload_url from presign instead.", "body": { "mode": "raw", "raw": "{\n \"file\": \"(multipart binary — local storage only; FILE_006 when MinIO active)\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Complete upload", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/complete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "complete" ], "query": [], "variable": [] }, "description": "Mark upload completed after binary is stored; optional checksum_sha256. When storage=s3, object must exist or FILE_011. Only the uploader may complete.", "body": { "mode": "raw", "raw": "{\n \"document_id\": \"{{document_id}}\",\n \"checksum_sha256\": \"abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/complete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", "complete" ], "query": [], "variable": [] }, "description": "Mark upload completed after binary is stored; optional checksum_sha256. When storage=s3, object must exist or FILE_011. Only the uploader may complete.", "body": { "mode": "raw", "raw": "{\n \"document_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"checksum_sha256\": \"abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. Get document (metadata + download_url)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Return one File by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Return one File by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "08. Download (local stream only)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id", "download" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Stream local document bytes only. When MinIO/S3 is configured, use download_url from GET /app/files/{id} (FILE_006 if download hit while s3 active).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id", "download" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Stream local document bytes only. When MinIO/S3 is configured, use download_url from GET /app/files/{id} (FILE_006 if download hit while s3 active).", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "09. Delete document", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing File. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/files/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "files", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{document_id}}", "description": "Path parameter" } ] }, "description": "Delete an existing File. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "6.3 Submit Report", "description": "**Purpose:** create draft report from event, submit, withdraw, versions\n**Prereq:** wizard completeness; `Idempotency-Key` on create/submit\n**Vars:** `report_id`\n**Playbook:** `docs/api/disaster-input/reporting.md`", "item": [ { "name": "01. List Report", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports" ], "query": [], "variable": [] }, "description": "Return a list of Report. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports" ], "query": [], "variable": [] }, "description": "Return a list of Report. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Report", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports" ], "query": [], "variable": [] }, "description": "Create a new Report from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440001\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports" ], "query": [], "variable": [] }, "description": "Create a new Report from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440001\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('report_id', payload.id);" ] } } ] }, { "name": "03. Get Report detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Return one Report by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Return one Report by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Submit Submit", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/submit", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "submit" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/submit", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "submit" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"submitted\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Withdraw Withdraw", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/withdraw", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "withdraw" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/withdraw", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "withdraw" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Versions Version", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. ShowVersion Version", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions/:versionId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions", ":versionId" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" }, { "key": "versionId", "value": "{{version_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions/:versionId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions", ":versionId" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" }, { "key": "versionId", "value": "{{version_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "08. Restore Restore", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions/:versionId/restore", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions", ":versionId", "restore" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" }, { "key": "versionId", "value": "{{version_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/:id/versions/:versionId/restore", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", ":id", "versions", ":versionId", "restore" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" }, { "key": "versionId", "value": "{{version_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "6.4 Approval", "description": "**Purpose:** take → return/approve; comments; SoD on approve\n**Prereq:** submitted report; approver permissions\n**Vars:** uses `report_id`\n**Playbook:** `docs/api/disaster-input/reporting.md`", "item": [ { "name": "01. Comments Comment", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/comments", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "comments" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/comments", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "comments" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"report_id\": \"\",\n \"status\": \"in_review\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Take Take", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/take", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "take" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/take", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "take" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"report_id\": \"\",\n \"status\": \"in_review\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. ReturnReport Return", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/return", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "return" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"comment\": \"Perbaiki data korban desa X\",\n \"issues\": [\n {\n \"code\": \"CASUALTY\",\n \"message\": \"Jumlah tidak konsisten\",\n \"field\": \"casualties\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/return", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "return" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"comment\": \"Perbaiki data korban desa X\",\n \"issues\": [\n {\n \"code\": \"CASUALTY\",\n \"message\": \"Jumlah tidak konsisten\",\n \"field\": \"casualties\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"report_id\": \"\",\n \"status\": \"in_review\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Approve Approve", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/approve", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "approve" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/approve", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "approve" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"report_id\": \"\",\n \"status\": \"approved\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. StoreComment Comment", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/comments", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "comments" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"body\": \"Mohon lengkapi foto dampak sebelum resubmit.\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/approvals/:reportId/comments", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "approvals", ":reportId", "comments" ], "query": [], "variable": [ { "key": "reportId", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"body\": \"Mohon lengkapi foto dampak sebelum resubmit.\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"report_id\": \"\",\n \"status\": \"in_review\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "6.5 Publication", "description": "**Purpose:** publish approved report; pin/unpin; unpublish; revise\n**Prereq:** approved report; `Idempotency-Key` on publish\n**Vars:** `publication_id`\n**Playbook:** `docs/api/disaster-input/publication.md`", "item": [ { "name": "01. List Publication", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications" ], "query": [], "variable": [] }, "description": "Return a list of Publication. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications" ], "query": [], "variable": [] }, "description": "Return a list of Publication. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Publication", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications" ], "query": [], "variable": [] }, "description": "Create a new Publication from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"report_id\": \"550e8400-e29b-41d4-a716-446655440010\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }, { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Required idempotency key" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications" ], "query": [], "variable": [] }, "description": "Create a new Publication from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"report_id\": \"550e8400-e29b-41d4-a716-446655440010\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "function saveEnv(key, value) {", " if (value === undefined || value === null || value === '') return;", " pm.environment.set(key, String(value));", " try { pm.collectionVariables.set(key, String(value)); } catch (e) {}", "}", "let payload = {};", "try {", " const json = pm.response.json();", " payload = (json && json.data) ? json.data : (json || {});", "} catch (e) { payload = {}; }", "saveEnv('publication_id', payload.id);" ] } } ] }, { "name": "03. Get Publication detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "Return one Publication by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "Return one Publication by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Unpublish Unpublish", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/unpublish", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "unpublish" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Koreksi data publik sebelum pin ulang\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/unpublish", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "unpublish" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Koreksi data publik sebelum pin ulang\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Pin Pin", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/pin", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "pin" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Atensi banjir wilayah Bandung\",\n \"priority\": 1,\n \"expires_at\": \"2026-07-20T23:59:59+07:00\",\n \"target_audience\": \"public\",\n \"channels\": [\n \"public_app\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/pin", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "pin" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Atensi banjir wilayah Bandung\",\n \"priority\": 1,\n \"expires_at\": \"2026-07-20T23:59:59+07:00\",\n \"target_audience\": \"public\",\n \"channels\": [\n \"public_app\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Revise Revision", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/revision", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "revision" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/revision", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "revision" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. Unpin Pin", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/pin", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "pin" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/publications/:id/pin", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "publications", ":id", "pin" ], "query": [], "variable": [ { "key": "id", "value": "{{publication_id}}", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"published\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "7. Reports", "description": "**Purpose:** analytics recap preview + export history under `/app/reports/*`\n**Prereq:** JWT + 2FA + `events.view`\n**File:** `POST /app/reports/exports` Excel or PDF (GET …/export removed)\n**Playbook:** `docs/api/reporting/README.md`", "item": [ { "name": "7.1 Rekap Penanganan", "description": "**Purpose:** preview A–F handling checklist from Step 3 matrix\n**Endpoints:** `GET /app/reports/penanganan-bencana`\n**Excel:** `POST /app/reports/exports` report_kind=penanganan_bencana\n**Playbook:** `docs/api/reporting/handling-recap.md`", "item": [ { "name": "01. Preview Penanganan Bencana", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/penanganan-bencana?date_from=2026-06-01&date_to=2026-06-30", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "penanganan-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days from date_from.", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional master_disaster_types.id filter. Omit = all types.", "disabled": true }, { "key": "region_code", "value": "32.04", "description": "Optional kab/kota (regions level=2). Omit = all in-scope Jawa Barat kab/kota.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/penanganan-bencana?date_from=2026-06-01&date_to=2026-06-30", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "penanganan-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days from date_from.", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional master_disaster_types.id filter. Omit = all types.", "disabled": true }, { "key": "region_code", "value": "32.04", "description": "Optional kab/kota (regions level=2). Omit = all in-scope Jawa Barat kab/kota.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7.2 Rekap Total Bencana", "description": "**Purpose:** kab/kota pivot preview with `recap_mode`\n**Endpoints:** `GET /app/reports/total-bencana`\n**Excel:** `POST /app/reports/exports` report_kind=total_bencana\n**Playbook:** `docs/api/reporting/total-bencana-recap.md`", "item": [ { "name": "01. Preview Total Bencana", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/total-bencana?date_from=2026-06-01&date_to=2026-06-30&recap_mode=non_threshold", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "total-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "non_threshold", "description": "Report mode: threshold (filters events by eligibility; layout unchanged) or non_threshold (all in-period events).", "disabled": false }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true }, { "key": "disaster_type_id[]", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional repeated active kebencanaan master_disaster_types ids. Damkar/inactive ids return 422. Omit = all types (jenis columns still kebencanaan-only).", "disabled": true }, { "key": "region_code[]", "value": "32.04", "description": "Optional repeated kab/kota code (regions level=2). Omit = all in-scope.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/total-bencana?date_from=2026-06-01&date_to=2026-06-30&recap_mode=non_threshold", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "total-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "non_threshold", "description": "Report mode: threshold (filters events by eligibility; layout unchanged) or non_threshold (all in-period events).", "disabled": false }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true }, { "key": "disaster_type_id[]", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional repeated active kebencanaan master_disaster_types ids. Damkar/inactive ids return 422. Omit = all types (jenis columns still kebencanaan-only).", "disabled": true }, { "key": "region_code[]", "value": "32.04", "description": "Optional repeated kab/kota code (regions level=2). Omit = all in-scope.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7.3 Rekap per Kejadian", "description": "**Purpose:** desa-grain preview (`impact_records`)\n**Endpoints:** `GET /app/reports/rekap-per-kejadian`\n**Excel:** `POST /app/reports/exports` report_kind=rekap_per_kejadian\n**Playbook:** `docs/api/reporting/rekap-per-kejadian.md`", "item": [ { "name": "01. Preview Rekap Per Kejadian", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/rekap-per-kejadian?date_from=2026-06-01&date_to=2026-06-30&recap_mode=non_threshold&disaster_type_id=8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "rekap-per-kejadian" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "non_threshold", "description": "Template mode: threshold (matrix + kerusakan groups) or non_threshold (flat).", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Required active kebencanaan master_disaster_types id. Damkar/inactive → 422.", "disabled": false }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/rekap-per-kejadian?date_from=2026-06-01&date_to=2026-06-30&recap_mode=non_threshold&disaster_type_id=8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "rekap-per-kejadian" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "non_threshold", "description": "Template mode: threshold (matrix + kerusakan groups) or non_threshold (flat).", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Required active kebencanaan master_disaster_types id. Damkar/inactive → 422.", "disabled": false }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7.4 Rekap Per Sebaran", "description": "**Purpose:** desa-grain preview grouped by kab (sections / multi-sheet Excel)\n**Endpoints:** `GET /app/reports/rekap-per-sebaran`\n**Excel:** `POST /app/reports/exports` report_kind=rekap_per_sebaran\n**Playbook:** `docs/api/reporting/rekap-per-sebaran.md`", "item": [ { "name": "01. Preview Rekap Per Sebaran", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/rekap-per-sebaran?date_from=2026-06-01&date_to=2026-06-30&recap_mode=threshold&disaster_type_id=8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "rekap-per-sebaran" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "threshold", "description": "Template mode: threshold (lat/lng + matrix) or non_threshold (jenis flags).", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Required active kebencanaan master_disaster_types id (min 1). Damkar/inactive → 422.", "disabled": false }, { "key": "region_code", "value": "32.04", "description": "Optional Jawa Barat level-2 kab/kota code (parent 32). Repeatable.", "disabled": true }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/rekap-per-sebaran?date_from=2026-06-01&date_to=2026-06-30&recap_mode=threshold&disaster_type_id=8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "rekap-per-sebaran" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "recap_mode", "value": "threshold", "description": "Template mode: threshold (lat/lng + matrix) or non_threshold (jenis flags).", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Required active kebencanaan master_disaster_types id (min 1). Damkar/inactive → 422.", "disabled": false }, { "key": "region_code", "value": "32.04", "description": "Optional Jawa Barat level-2 kab/kota code (parent 32). Repeatable.", "disabled": true }, { "key": "opd", "value": "bpbd", "description": "Optional OPD code filter via master_opds.code. Allowed: bpbd, damkar.", "disabled": true } ], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7.5 Log Harian", "description": "**Purpose:** narrative PDF per kejadian (export-only; no GET preview)\n**Endpoints:** `POST /app/reports/exports` report_kind=log_harian\n**PDF:** A4 portrait; filters: date + disaster_type_id[] (min 1, kebencanaan/damkar); optional region_code[]\n**Playbook:** `docs/api/reporting/log-harian.md`", "item": [] }, { "name": "7.6 Gallery Bencana", "description": "**Purpose:** paginated event photo cards + landscape PDF gallery\n**Endpoints:** `GET /app/reports/gallery-bencana`\n**PDF:** `POST /app/reports/exports` report_kind=gallery_bencana (4-col landscape)\n**Playbook:** `docs/api/reporting/gallery-bencana.md`", "item": [ { "name": "01. Preview Gallery Bencana", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/gallery-bencana?date_from=2026-06-01&date_to=2026-06-30", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "gallery-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional active disaster type id (kebencanaan or damkar). Omit = all. Repeatable.", "disabled": true }, { "key": "region_code", "value": "32.04", "description": "Optional Jawa Barat level-2 kab/kota code (parent 32). Repeatable.", "disabled": true }, { "key": "start", "value": "0", "description": "Pagination offset (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Pagination page size (default 20, max 100).", "disabled": true } ], "variable": [] }, "description": "JSON preview of Gallery Bencana photo cards (1 card per event with newest event-level image). Required: date_from, date_to. Optional disaster_type_id[] (kebencanaan/damkar), region_code[] (Jabar L2), start/length pagination. No recap_mode/opd. PDF via POST /app/reports/exports (report_kind=gallery_bencana). Playbook: docs/api/reporting/gallery-bencana.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/gallery-bencana?date_from=2026-06-01&date_to=2026-06-30", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "gallery-bencana" ], "query": [ { "key": "date_from", "value": "2026-06-01", "description": "Inclusive start date (Y-m-d) on disaster_events.occurred_at.", "disabled": false }, { "key": "date_to", "value": "2026-06-30", "description": "Inclusive end date (Y-m-d). Max 366 inclusive days.", "disabled": false }, { "key": "disaster_type_id", "value": "8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3", "description": "Optional active disaster type id (kebencanaan or damkar). Omit = all. Repeatable.", "disabled": true }, { "key": "region_code", "value": "32.04", "description": "Optional Jawa Barat level-2 kab/kota code (parent 32). Repeatable.", "disabled": true }, { "key": "start", "value": "0", "description": "Pagination offset (default 0).", "disabled": true }, { "key": "length", "value": "20", "description": "Pagination page size (default 20, max 100).", "disabled": true } ], "variable": [] }, "description": "JSON preview of Gallery Bencana photo cards (1 card per event with newest event-level image). Required: date_from, date_to. Optional disaster_type_id[] (kebencanaan/damkar), region_code[] (Jabar L2), start/length pagination. No recap_mode/opd. PDF via POST /app/reports/exports (report_kind=gallery_bencana). Playbook: docs/api/reporting/gallery-bencana.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "7.7 Export History", "description": "**Purpose:** generate Excel/PDF + list/show/download history (TTL 15 days)\n**Endpoints:** `POST/GET /app/reports/exports`, `GET .../{id}`, `GET .../{id}/download`\n**Prereq:** `Idempotency-Key` on POST\n**Playbook:** `docs/api/reporting/README.md`", "item": [ { "name": "01. Generate analytics Excel/PDF + history", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "Generate analytics Excel or PDF, store on MinIO/local, create history row (TTL 15 days). Body: report_kind + filters. Kinds: penanganan_bencana, total_bencana, rekap_per_kejadian, rekap_per_sebaran (Excel); log_harian, gallery_bencana (PDF). gallery_bencana: optional type/region, no recap_mode/opd. Requires Idempotency-Key + events.view. Returns history + download_url. Playbook: docs/api/reporting/README.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"penanganan_bencana\",\n \"name\": \"Rekap Penanganan Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "Generate analytics Excel or PDF, store on MinIO/local, create history row (TTL 15 days). Body: report_kind + filters. Kinds: penanganan_bencana, total_bencana, rekap_per_kejadian, rekap_per_sebaran (Excel); log_harian, gallery_bencana (PDF). gallery_bencana: optional type/region, no recap_mode/opd. Requires Idempotency-Key + events.view. Returns history + download_url. Playbook: docs/api/reporting/README.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"penanganan_bencana\",\n \"name\": \"Rekap Penanganan Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Log Harian PDF export", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "Export-only PDF (no GET preview). Requires disaster_type_id[] (min 1; kebencanaan or damkar). Do not send recap_mode/opd. Playbook: docs/api/reporting/log-harian.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"log_harian\",\n \"name\": \"Log Harian Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "Generate analytics Excel or PDF, store on MinIO/local, create history row (TTL 15 days). Body: report_kind + filters. Kinds: penanganan_bencana, total_bencana, rekap_per_kejadian, rekap_per_sebaran (Excel); log_harian, gallery_bencana (PDF). gallery_bencana: optional type/region, no recap_mode/opd. Requires Idempotency-Key + events.view. Returns history + download_url. Playbook: docs/api/reporting/README.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"penanganan_bencana\",\n \"name\": \"Rekap Penanganan Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Create Gallery Bencana PDF export", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "PDF landscape gallery (4 columns). Optional disaster_type_id[] / region_code[] (omit = all). No recap_mode/opd. Playbook: docs/api/reporting/gallery-bencana.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"gallery_bencana\",\n \"name\": \"Gallery Bencana Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "Generate analytics Excel or PDF, store on MinIO/local, create history row (TTL 15 days). Body: report_kind + filters. Kinds: penanganan_bencana, total_bencana, rekap_per_kejadian, rekap_per_sebaran (Excel); log_harian, gallery_bencana (PDF). gallery_bencana: optional type/region, no recap_mode/opd. Requires Idempotency-Key + events.view. Returns history + download_url. Playbook: docs/api/reporting/README.md.", "body": { "mode": "raw", "raw": "{\n \"report_kind\": \"penanganan_bencana\",\n \"name\": \"Rekap Penanganan Juni 2026\",\n \"date_from\": \"2026-06-01\",\n \"date_to\": \"2026-06-30\",\n \"disaster_type_id\": [\n \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\"\n ],\n \"region_code\": [\n \"32.04\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. List analytics export history", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "List current user non-expired analytics export history (start/length/search). Permission events.view. Playbook: docs/api/reporting/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports" ], "query": [], "variable": [] }, "description": "List current user non-expired analytics export history (start/length/search). Permission events.view. Playbook: docs/api/reporting/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Download analytics export file", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports", ":id", "download" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Stream Excel/PDF for owned non-expired export (local disk; S3 clients usually use download_url). Permission events.view. Playbook: docs/api/reporting/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports", ":id", "download" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Stream Excel/PDF for owned non-expired export (local disk; S3 clients usually use download_url). Permission events.view. Playbook: docs/api/reporting/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. Show analytics export history detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Show one owned non-expired analytics export with refreshed download_url. Permission events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/reports/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "reports", "exports", ":id" ], "query": [], "variable": [ { "key": "id", "value": "{{report_id}}", "description": "Path parameter" } ] }, "description": "Show one owned non-expired analytics export with refreshed download_url. Permission events.view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\",\n \"status\": \"draft\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] }, { "name": "8. Volunteer Management", "description": "**Purpose:** internal volunteer management (list/CRUD personals, communities, and roster members)\n**Prereq:** JWT + 2FA + `volunteers.view`/`create`/`update`/`delete` permissions\n**Playbook:** `docs/api/volunteers/README.md`", "item": [ { "name": "01. IndexMembers Member", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "members" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "members" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. StoreMember Member", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "members" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"3204011508950011\",\n \"full_name\": \"Agus Pratama\",\n \"birth_place\": \"Bandung\",\n \"birth_date\": \"1995-08-15\",\n \"gender\": \"pria\",\n \"blood_type\": \"O\",\n \"phone\": \"081211112222\",\n \"email\": \"agus.pratama@example.com\",\n \"address\": \"Jl. Raya Soreang No. 10\",\n \"regency_code\": \"32.04\",\n \"district_code\": \"32.04.01\",\n \"village_code\": \"32.04.01.2001\",\n \"lat\": -7.0311,\n \"lng\": 107.5255,\n \"role_in_community\": \"Koordinator Lapangan\",\n \"skills\": [\n \"sar\",\n \"evakuasi\"\n ],\n \"medical_history\": \"Sehat\",\n \"emergency_contact_name\": \"Ibu Agus\",\n \"emergency_contact_phone\": \"081299991111\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "members" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"3204011508950011\",\n \"full_name\": \"Agus Pratama\",\n \"birth_place\": \"Bandung\",\n \"birth_date\": \"1995-08-15\",\n \"gender\": \"pria\",\n \"blood_type\": \"O\",\n \"phone\": \"081211112222\",\n \"email\": \"agus.pratama@example.com\",\n \"address\": \"Jl. Raya Soreang No. 10\",\n \"regency_code\": \"32.04\",\n \"district_code\": \"32.04.01\",\n \"village_code\": \"32.04.01.2001\",\n \"lat\": -7.0311,\n \"lng\": 107.5255,\n \"role_in_community\": \"Koordinator Lapangan\",\n \"skills\": [\n \"sar\",\n \"evakuasi\"\n ],\n \"medical_history\": \"Sehat\",\n \"emergency_contact_name\": \"Ibu Agus\",\n \"emergency_contact_phone\": \"081299991111\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. UpdateMember Member", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:communityId/members/:memberId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":communityId", "members", ":memberId" ], "query": [], "variable": [ { "key": "communityId", "value": "", "description": "Path parameter" }, { "key": "memberId", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Agus Pratama Updated\",\n \"role_in_community\": \"Ketua Koordinator Lapangan\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:communityId/members/:memberId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":communityId", "members", ":memberId" ], "query": [], "variable": [ { "key": "communityId", "value": "", "description": "Path parameter" }, { "key": "memberId", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Agus Pratama Updated\",\n \"role_in_community\": \"Ketua Koordinator Lapangan\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. DestroyMember Member", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:communityId/members/:memberId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":communityId", "members", ":memberId" ], "query": [], "variable": [ { "key": "communityId", "value": "", "description": "Path parameter" }, { "key": "memberId", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:communityId/members/:memberId", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":communityId", "members", ":memberId" ], "query": [], "variable": [ { "key": "communityId", "value": "", "description": "Path parameter" }, { "key": "memberId", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Export Export", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "export" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "export" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "06. IndexPersonals Personal", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "07. IndexCommunities Community", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities" ], "query": [], "variable": [] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "08. ShowPersonal Personal", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "09. ShowCommunity Community", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "10. StorePersonal Personal", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals" ], "query": [], "variable": [] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"\",\n \"full_name\": \"\",\n \"birth_place\": \"\",\n \"birth_date\": \"2025-01-01\",\n \"gender\": \"\",\n \"blood_type\": \"\",\n \"phone\": \"+1234567890\",\n \"email\": \"user@example.com\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"skills\": [\n null\n ],\n \"skills.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"medical_history\": \"\",\n \"emergency_contact_name\": \"+62-811-2233-4455\",\n \"emergency_contact_phone\": \"+62-811-2233-4455\",\n \"privacy_consent\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals" ], "query": [], "variable": [] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"\",\n \"full_name\": \"\",\n \"birth_place\": \"\",\n \"birth_date\": \"2025-01-01\",\n \"gender\": \"\",\n \"blood_type\": \"\",\n \"phone\": \"+1234567890\",\n \"email\": \"user@example.com\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"skills\": [\n null\n ],\n \"skills.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"medical_history\": \"\",\n \"emergency_contact_name\": \"+62-811-2233-4455\",\n \"emergency_contact_phone\": \"+62-811-2233-4455\",\n \"privacy_consent\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "11. StoreCommunity Community", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities" ], "query": [], "variable": [] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"\",\n \"sk_number\": \"\",\n \"legal_document\": \"\",\n \"focus_areas\": [\n null\n ],\n \"focus_areas.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"pic_name\": \"\",\n \"pic_nik\": \"\",\n \"pic_phone\": \"+1234567890\",\n \"pic_email\": \"user@example.com\",\n \"main_assets\": \"\",\n \"privacy_consent\": true,\n \"members\": [\n null\n ],\n \"members.*.nik\": \"\",\n \"members.*.full_name\": \"\",\n \"members.*.birth_place\": \"\",\n \"members.*.birth_date\": \"2025-01-01\",\n \"members.*.gender\": \"\",\n \"members.*.blood_type\": \"\",\n \"members.*.phone\": \"+1234567890\",\n \"members.*.email\": \"user@example.com\",\n \"members.*.address\": \"\",\n \"members.*.regency_code\": \"\",\n \"members.*.district_code\": \"\",\n \"members.*.village_code\": \"\",\n \"members.*.lat\": -6.90389,\n \"members.*.lng\": 107.61861,\n \"members.*.role_in_community\": \"\",\n \"members.*.skills\": [\n null\n ],\n \"members.*.skills.*\": \"\",\n \"members.*.medical_history\": \"\",\n \"members.*.emergency_contact_name\": \"+62-811-2233-4455\",\n \"members.*.emergency_contact_phone\": \"+62-811-2233-4455\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities" ], "query": [], "variable": [] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"\",\n \"sk_number\": \"\",\n \"legal_document\": \"\",\n \"focus_areas\": [\n null\n ],\n \"focus_areas.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"pic_name\": \"\",\n \"pic_nik\": \"\",\n \"pic_phone\": \"+1234567890\",\n \"pic_email\": \"user@example.com\",\n \"main_assets\": \"\",\n \"privacy_consent\": true,\n \"members\": [\n null\n ],\n \"members.*.nik\": \"\",\n \"members.*.full_name\": \"\",\n \"members.*.birth_place\": \"\",\n \"members.*.birth_date\": \"2025-01-01\",\n \"members.*.gender\": \"\",\n \"members.*.blood_type\": \"\",\n \"members.*.phone\": \"+1234567890\",\n \"members.*.email\": \"user@example.com\",\n \"members.*.address\": \"\",\n \"members.*.regency_code\": \"\",\n \"members.*.district_code\": \"\",\n \"members.*.village_code\": \"\",\n \"members.*.lat\": -6.90389,\n \"members.*.lng\": 107.61861,\n \"members.*.role_in_community\": \"\",\n \"members.*.skills\": [\n null\n ],\n \"members.*.skills.*\": \"\",\n \"members.*.medical_history\": \"\",\n \"members.*.emergency_contact_name\": \"+62-811-2233-4455\",\n \"members.*.emergency_contact_phone\": \"+62-811-2233-4455\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "12. UpdatePersonal Personal", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"\",\n \"full_name\": \"\",\n \"birth_place\": \"\",\n \"birth_date\": \"2025-01-01\",\n \"gender\": \"\",\n \"blood_type\": \"\",\n \"phone\": \"+1234567890\",\n \"email\": \"user@example.com\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"skills\": [\n null\n ],\n \"skills.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"medical_history\": \"\",\n \"emergency_contact_name\": \"+62-811-2233-4455\",\n \"emergency_contact_phone\": \"+62-811-2233-4455\",\n \"privacy_consent\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"nik\": \"\",\n \"full_name\": \"\",\n \"birth_place\": \"\",\n \"birth_date\": \"2025-01-01\",\n \"gender\": \"\",\n \"blood_type\": \"\",\n \"phone\": \"+1234567890\",\n \"email\": \"user@example.com\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"skills\": [\n null\n ],\n \"skills.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"medical_history\": \"\",\n \"emergency_contact_name\": \"+62-811-2233-4455\",\n \"emergency_contact_phone\": \"+62-811-2233-4455\",\n \"privacy_consent\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "13. UpdateCommunity Community", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"\",\n \"sk_number\": \"\",\n \"legal_document\": \"\",\n \"focus_areas\": [\n null\n ],\n \"focus_areas.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"pic_name\": \"\",\n \"pic_nik\": \"\",\n \"pic_phone\": \"+1234567890\",\n \"pic_email\": \"user@example.com\",\n \"main_assets\": \"\",\n \"privacy_consent\": true,\n \"members\": [\n null\n ],\n \"members.*.nik\": \"\",\n \"members.*.full_name\": \"\",\n \"members.*.birth_place\": \"\",\n \"members.*.birth_date\": \"2025-01-01\",\n \"members.*.gender\": \"\",\n \"members.*.blood_type\": \"\",\n \"members.*.phone\": \"+1234567890\",\n \"members.*.email\": \"user@example.com\",\n \"members.*.address\": \"\",\n \"members.*.regency_code\": \"\",\n \"members.*.district_code\": \"\",\n \"members.*.village_code\": \"\",\n \"members.*.lat\": -6.90389,\n \"members.*.lng\": 107.61861,\n \"members.*.role_in_community\": \"\",\n \"members.*.skills\": [\n null\n ],\n \"members.*.skills.*\": \"\",\n \"members.*.medical_history\": \"\",\n \"members.*.emergency_contact_name\": \"+62-811-2233-4455\",\n \"members.*.emergency_contact_phone\": \"+62-811-2233-4455\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"community_name\": \"\",\n \"sk_number\": \"\",\n \"legal_document\": \"\",\n \"focus_areas\": [\n null\n ],\n \"focus_areas.*\": \"\",\n \"photos\": [\n null\n ],\n \"photos.*\": \"\",\n \"documents\": [\n null\n ],\n \"documents.*\": \"\",\n \"address\": \"\",\n \"regency_code\": \"\",\n \"lat\": -6.90389,\n \"lng\": 107.61861,\n \"pic_name\": \"\",\n \"pic_nik\": \"\",\n \"pic_phone\": \"+1234567890\",\n \"pic_email\": \"user@example.com\",\n \"main_assets\": \"\",\n \"privacy_consent\": true,\n \"members\": [\n null\n ],\n \"members.*.nik\": \"\",\n \"members.*.full_name\": \"\",\n \"members.*.birth_place\": \"\",\n \"members.*.birth_date\": \"2025-01-01\",\n \"members.*.gender\": \"\",\n \"members.*.blood_type\": \"\",\n \"members.*.phone\": \"+1234567890\",\n \"members.*.email\": \"user@example.com\",\n \"members.*.address\": \"\",\n \"members.*.regency_code\": \"\",\n \"members.*.district_code\": \"\",\n \"members.*.village_code\": \"\",\n \"members.*.lat\": -6.90389,\n \"members.*.lng\": 107.61861,\n \"members.*.role_in_community\": \"\",\n \"members.*.skills\": [\n null\n ],\n \"members.*.skills.*\": \"\",\n \"members.*.medical_history\": \"\",\n \"members.*.emergency_contact_name\": \"+62-811-2233-4455\",\n \"members.*.emergency_contact_phone\": \"+62-811-2233-4455\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "14. UpdatePersonalStatus Status", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id", "status" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"status\": \"approved\",\n \"rejection_reason\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id", "status" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"status\": \"approved\",\n \"rejection_reason\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "15. UpdateCommunityStatus Status", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "status" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"status\": \"approved\",\n \"rejection_reason\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id", "status" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"status\": \"approved\",\n \"rejection_reason\": null\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "16. DestroyPersonal Personal", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/personals/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "personals", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "17. DestroyCommunity Community", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/public/volunteers/communities/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "public", "volunteers", "communities", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "9. Information & Education (CMS)", "description": "**Purpose:** internal education article CMS CRUD\n**Prereq:** JWT + 2FA + `educations.view`/`create`/`update`/`delete` permissions", "item": [ { "name": "01. List Education", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations" ], "query": [], "variable": [] }, "description": "Return a list of Education. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations" ], "query": [], "variable": [] }, "description": "Return a list of Education. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get Education detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Education by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Return one Education by identifier. Use this endpoint for full detail view.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Create Education", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations" ], "query": [], "variable": [] }, "description": "Create a new Education from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"title\": \"Banjir Bandang Bandung\",\n \"content\": \"\",\n \"image_path\": \"\",\n \"youtube_url\": \"https://example.com\",\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations" ], "query": [], "variable": [] }, "description": "Create a new Education from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"title\": \"Banjir Bandang Bandung\",\n \"content\": \"\",\n \"image_path\": \"\",\n \"youtube_url\": \"https://example.com\",\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Update Education", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Education, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"title\": \"Banjir Bandang Bandung\",\n \"content\": \"\",\n \"image_path\": \"\",\n \"youtube_url\": \"https://example.com\",\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Partially or fully update an existing Education, depending on endpoint semantics. Event PATCH requires version for optimistic lock (autosave).", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"8f3f2f0f-5d6e-4e0a-9df8-4fd2f24a8fd3\",\n \"title\": \"Banjir Bandang Bandung\",\n \"content\": \"\",\n \"image_path\": \"\",\n \"youtube_url\": \"https://example.com\",\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Delete Education", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Education. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/educations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "educations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Education. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "10. Mitigation (CMS)", "description": "**Purpose:** internal mitigation guide CMS CRUD\n**Prereq:** JWT + 2FA + `mitigations.view`/`create`/`update`/`delete` permissions", "item": [ { "name": "01. List internal disaster mitigation guides", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations" ], "query": [ { "key": "start", "value": "0", "description": "Offset start index for pagination.", "disabled": true }, { "key": "length", "value": "15", "description": "Page size / limit (max 100).", "disabled": true }, { "key": "search", "value": "gempa", "description": "Search keyword for mitigation title.", "disabled": true }, { "key": "disaster_type_id", "value": "550e8400-e29b-41d4-a716-446655440000", "description": "Filter by disaster type ID.", "disabled": true }, { "key": "status", "value": "published", "description": "Filter by status (draft or published).", "disabled": true } ], "variable": [] }, "description": "Retrieve a list of disaster mitigation guides for internal dashboard. Filterable by search, status (draft/published), and disaster_type_id.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations" ], "query": [ { "key": "start", "value": "0", "description": "Offset start index for pagination.", "disabled": true }, { "key": "length", "value": "15", "description": "Page size / limit (max 100).", "disabled": true }, { "key": "search", "value": "gempa", "description": "Search keyword for mitigation title.", "disabled": true }, { "key": "disaster_type_id", "value": "550e8400-e29b-41d4-a716-446655440000", "description": "Filter by disaster type ID.", "disabled": true }, { "key": "status", "value": "published", "description": "Filter by status (draft or published).", "disabled": true } ], "variable": [] }, "description": "Retrieve a list of disaster mitigation guides for internal dashboard. Filterable by search, status (draft/published), and disaster_type_id.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Get internal disaster mitigation guide detail", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Retrieve details of a disaster mitigation guide by its UUID for the internal dashboard.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Retrieve details of a disaster mitigation guide by its UUID for the internal dashboard.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Create new disaster mitigation guide", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations" ], "query": [], "variable": [] }, "description": "Create a new disaster mitigation guide with nested media items. Wrap in database transaction. Requires a unique Idempotency-Key.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"Panduan Mitigasi Gempa Bumi\",\n \"status\": \"draft\",\n \"items\": [\n {\n \"type\": \"article\",\n \"title\": \"Langkah Menyelamatkan Diri\",\n \"content\": \"

Segera lindungi kepala Anda dengan bantal atau helm...

\",\n \"order\": 1\n },\n {\n \"type\": \"youtube\",\n \"title\": \"Video Simulasi Evakuasi\",\n \"youtube_url\": \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\",\n \"order\": 2\n },\n {\n \"type\": \"image\",\n \"title\": \"Infografis Jalur Evakuasi\",\n \"image_path\": \"files/mitigations/infografis-jalur.jpg\",\n \"order\": 3\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations" ], "query": [], "variable": [] }, "description": "Create a new disaster mitigation guide with nested media items. Wrap in database transaction. Requires a unique Idempotency-Key.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"Panduan Mitigasi Gempa Bumi\",\n \"status\": \"draft\",\n \"items\": [\n {\n \"type\": \"article\",\n \"title\": \"Langkah Menyelamatkan Diri\",\n \"content\": \"

Segera lindungi kepala Anda dengan bantal atau helm...

\",\n \"order\": 1\n },\n {\n \"type\": \"youtube\",\n \"title\": \"Video Simulasi Evakuasi\",\n \"youtube_url\": \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\",\n \"order\": 2\n },\n {\n \"type\": \"image\",\n \"title\": \"Infografis Jalur Evakuasi\",\n \"image_path\": \"files/mitigations/infografis-jalur.jpg\",\n \"order\": 3\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Update disaster mitigation guide", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update an existing disaster mitigation guide and its child media items within a database transaction.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"Panduan Mitigasi Gempa Bumi Ter-update\",\n \"status\": \"published\",\n \"items\": [\n {\n \"type\": \"article\",\n \"title\": \"Langkah Menyelamatkan Diri Baru\",\n \"content\": \"

Gunakan helm pelindung...

\",\n \"order\": 1\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Update an existing disaster mitigation guide and its child media items within a database transaction.", "body": { "mode": "raw", "raw": "{\n \"disaster_type_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"Panduan Mitigasi Gempa Bumi Ter-update\",\n \"status\": \"published\",\n \"items\": [\n {\n \"type\": \"article\",\n \"title\": \"Langkah Menyelamatkan Diri Baru\",\n \"content\": \"

Gunakan helm pelindung...

\",\n \"order\": 1\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "05. Delete disaster mitigation guide", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing disaster mitigation guide and its media items from the database.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/mitigations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "mitigations", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing disaster mitigation guide and its media items from the database.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "11. Homepage Background (CMS)", "description": "**Purpose:** internal homepage background image upload (MinIO S3), listing, publish toggle, and deletion\n**Prereq:** JWT + 2FA + `master.view` permission", "item": [ { "name": "01. List Homepage Background", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds" ], "query": [], "variable": [] }, "description": "Return a list of Homepage Background. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds" ], "query": [], "variable": [] }, "description": "Return a list of Homepage Background. Use query parameters for filtering, sorting, and pagination when available. Wizard master taxonomy is under authenticated /api/v1/app/master; see docs/api/disaster-input/README.md Step 0.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "02. Create Homepage Background", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds" ], "query": [], "variable": [] }, "description": "Create a new Homepage Background from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"images\": \"\",\n \"images.*\": \"\",\n \"image\": \"\",\n \"title\": \"Banjir Bandang Bandung\",\n \"is_published\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds" ], "query": [], "variable": [] }, "description": "Create a new Homepage Background from the request payload. Returns the created resource on success. For POST /app/events, Idempotency-Key header is required; disaster_name_id is required (penyebab); cause_id is prohibited.", "body": { "mode": "raw", "raw": "{\n \"images\": \"\",\n \"images.*\": \"\",\n \"image\": \"\",\n \"title\": \"Banjir Bandang Bandung\",\n \"is_published\": true\n}", "options": { "raw": { "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "03. Publish Publish", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds/:id/publish", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds", ":id", "publish" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds/:id/publish", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds", ":id", "publish" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] }, { "name": "04. Delete Homepage Background", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Homepage Background. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/homepage-backgrounds/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "homepage-backgrounds", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Path parameter" } ] }, "description": "Delete an existing Homepage Background. This may be soft-delete based on model configuration.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "12. External Data Sync", "description": "**Purpose:** trigger data synchronization from external upstream APIs (Dinsos, PVMBG)\n**Prereq:** JWT + 2FA + specific sync permissions", "item": [ { "name": "12.1 Logistics Sync (Dinsos)", "description": "**Purpose:** trigger synchronization from 5 SPLP Dinsos endpoints with anti-redundancy upserts\n**Prereq:** JWT + 2FA + `logistics.sync` permission\n**Playbook:** `docs/api/logistics/README.md`", "item": [ { "name": "01. Synchronize disaster logistics datasets from SPLP Dinsos API", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/logistics/sync", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "logistics", "sync" ], "query": [], "variable": [] }, "description": "Trigger synchronization from 5 SPLP Dinsos endpoints with anti-redundancy upserts and audit snapshots. Requires JWT, 2FA, and permission logistics.sync. Playbook: docs/api/logistics/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/logistics/sync", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "logistics", "sync" ], "query": [], "variable": [] }, "description": "Trigger synchronization from 5 SPLP Dinsos endpoints with anti-redundancy upserts and audit snapshots. Requires JWT, 2FA, and permission logistics.sync. Playbook: docs/api/logistics/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] }, { "name": "12.2 Landslide Sync (PVMBG)", "description": "**Purpose:** trigger synchronization of monthly landslide forecast vector assets from PVMBG\n**Prereq:** JWT + 2FA + `geohazard.sync` permission\n**Playbook:** `docs/api/geohazard/README.md`", "item": [ { "name": "01. Synchronize monthly PVMBG landslide forecast data from SPLP API", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/geohazard/landslide/sync", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "geohazard", "landslide", "sync" ], "query": [], "variable": [] }, "description": "Trigger synchronization of landslide forecast vector assets from PVMBG with anti-redundancy upserts and audit snapshots. Requires JWT, 2FA, and permission geohazard.sync. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "response": [ { "name": "Success example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/app/geohazard/landslide/sync", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "app", "geohazard", "landslide", "sync" ], "query": [], "variable": [] }, "description": "Trigger synchronization of landslide forecast vector assets from PVMBG with anti-redundancy upserts and audit snapshots. Requires JWT, 2FA, and permission geohazard.sync. Playbook: docs/api/geohazard/README.md.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"\"\n },\n \"message\": null,\n \"errors\": null,\n \"meta\": null\n}" } ] } ] } ] } ] } ] }