GovConnect API Testing Reference
Auth
# Login superadmin
$r = Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/auth/login" `
-Method POST -ContentType "application/json" `
-Body '{"username":"superadmin","password":"GovConnect2026!"}'
$SA_TOKEN = $r.token
# Login village admin
$r2 = Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/auth/login" `
-Method POST -ContentType "application/json" `
-Body '{"username":"admin_sangreseng","password":"SangresengAde2026!"}'
$VA_TOKEN = $r2.token
# Get current user
Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/auth/me" `
-Headers @{ Authorization = "Bearer $VA_TOKEN" }
Headers Helper
$SA_H = @{ Authorization = "Bearer $SA_TOKEN" }
$VA_H = @{ Authorization = "Bearer $VA_TOKEN" }
$INT_H = @{ "x-api-key" = "govconnect-internal-api-key-2025" }
Laporan / Complaint (via Dashboard Proxy)
# List laporan (village admin)
Invoke-RestMethod "http://127.0.0.1:3010/api/laporan" -Headers $VA_H
# List laporan dengan filter
Invoke-RestMethod "http://127.0.0.1:3010/api/laporan?status=OPEN&limit=10" -Headers $VA_H
# Detail laporan
Invoke-RestMethod "http://127.0.0.1:3010/api/laporan/LAP-20260101-001" -Headers $VA_H
# Update status laporan
Invoke-RestMethod "http://127.0.0.1:3010/api/laporan/LAP-20260101-001/status" `
-Method PATCH -ContentType "application/json" -Headers $VA_H `
-Body '{"status":"PROCESS","admin_notes":"Sedang ditindaklanjuti"}'
# Tambah update/catatan laporan
Invoke-RestMethod "http://127.0.0.1:3010/api/laporan/LAP-20260101-001/updates" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"note_text":"Tim sudah turun ke lapangan"}'
Kategori dan Jenis Pengaduan
# List kategori pengaduan (village admin)
Invoke-RestMethod "http://127.0.0.1:3010/api/complaints/categories" -Headers $VA_H
# Buat kategori baru
Invoke-RestMethod "http://127.0.0.1:3010/api/complaints/categories" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"name":"Infrastruktur","description":"Pengaduan infrastruktur desa"}'
# List jenis pengaduan
Invoke-RestMethod "http://127.0.0.1:3010/api/complaints/types" -Headers $VA_H
# Buat jenis pengaduan
Invoke-RestMethod "http://127.0.0.1:3010/api/complaints/types" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"category_id":"<cat-id>","name":"Jalan Rusak","is_urgent":false,"require_address":true}'
Layanan / Service Request (via Dashboard Proxy)
# List layanan
Invoke-RestMethod "http://127.0.0.1:3010/api/layanan" -Headers $VA_H
# Detail layanan
Invoke-RestMethod "http://127.0.0.1:3010/api/layanan/<service-id>" -Headers $VA_H
# List service requests
Invoke-RestMethod "http://127.0.0.1:3010/api/service-requests" -Headers $VA_H
# Detail service request
Invoke-RestMethod "http://127.0.0.1:3010/api/service-requests/<id>" -Headers $VA_H
# Update status service request
Invoke-RestMethod "http://127.0.0.1:3010/api/service-requests/<id>/status" `
-Method PATCH -ContentType "application/json" -Headers $VA_H `
-Body '{"status":"PROCESS","admin_notes":"Sedang diproses"}'
Nomor Penting / Important Contacts
# List kategori kontak penting
Invoke-RestMethod "http://127.0.0.1:3010/api/important-contacts/categories" -Headers $VA_H
# Buat kategori kontak
Invoke-RestMethod "http://127.0.0.1:3010/api/important-contacts/categories" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"name":"Darurat","description":"Nomor darurat desa"}'
# List kontak penting
Invoke-RestMethod "http://127.0.0.1:3010/api/important-contacts" -Headers $VA_H
# Buat kontak penting
Invoke-RestMethod "http://127.0.0.1:3010/api/important-contacts" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"category_id":"<cat-id>","name":"Kepala Desa","phone":"081234567890","description":"Nomor HP Kepala Desa"}'
Knowledge Base
# List knowledge
Invoke-RestMethod "http://127.0.0.1:3010/api/knowledge" -Headers $VA_H
# Buat knowledge
Invoke-RestMethod "http://127.0.0.1:3010/api/knowledge" `
-Method POST -ContentType "application/json" -Headers $VA_H `
-Body '{"title":"Syarat KTP","content":"Syarat membuat KTP: ...","category":"Layanan"}'
# Cek konsistensi knowledge
Invoke-RestMethod "http://127.0.0.1:3010/api/knowledge-consistency/scan" `
-Method POST -Headers $VA_H
AI Service - Simulasi Pesan WhatsApp
# Dapatkan village_id dulu
$village = Invoke-RestMethod "http://127.0.0.1:3010/api/villages/me" -Headers $VA_H
$VILLAGE_ID = $village.data.id
# Simulasi webhook WhatsApp masuk ke channel-service
$waBody = @{
type = "message"
village_id = $VILLAGE_ID
from = "6281234567890@s.whatsapp.net"
messageId = "test-msg-$(Get-Date -Format 'yyyyMMddHHmmss')"
timestamp = [int][double]::Parse((Get-Date -UFormat %s))
message = @{
conversation = "halo, mau tanya syarat buat KTP"
}
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "http://127.0.0.1:3001/webhook/whatsapp" `
-Method POST -ContentType "application/json" `
-Headers $INT_H -Body $waBody
# Simulasi laporan darurat
$urgentBody = @{
type = "message"
village_id = $VILLAGE_ID
from = "6281234567890@s.whatsapp.net"
messageId = "test-urgent-$(Get-Date -Format 'yyyyMMddHHmmss')"
timestamp = [int][double]::Parse((Get-Date -UFormat %s))
message = @{
conversation = "tolong ada kebakaran di RT 03!"
}
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "http://127.0.0.1:3001/webhook/whatsapp" `
-Method POST -ContentType "application/json" `
-Headers $INT_H -Body $urgentBody
AI Service - Direct API
# Health check AI service
Invoke-RestMethod "http://127.0.0.1:3002/health"
# Cek AI usage
Invoke-RestMethod "http://127.0.0.1:3010/api/ai-usage/messages" -Headers $VA_H
# Cek AI balance
Invoke-RestMethod "http://127.0.0.1:3010/api/ai-balance" -Headers $VA_H
Webchat Testing
# Kirim pesan via webchat
$webchatBody = @{
village_slug = "desa-sanreseng-ade"
session_id = "web_test_$(Get-Date -Format 'yyyyMMddHHmmss')"
message = "halo, mau tanya layanan apa saja yang tersedia?"
} | ConvertTo-Json
Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/webchat" `
-Method POST -ContentType "application/json" -Body $webchatBody
# Poll webchat response
Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/webchat/poll?session_id=web_test_xxx" `
-Method GET
Public Forms
# Cek layanan by slug (public)
Invoke-RestMethod "http://127.0.0.1:3010/api/public/services/by-slug?village_slug=desa-sanreseng-ade&service_slug=<slug>"
# Submit pengaduan publik
$complaintBody = @{
village_id = $VILLAGE_ID
kategori = "Jalan Rusak"
deskripsi = "Jalan di RT 03 berlubang besar"
alamat = "Jl. Desa RT 03"
channel = "WEBCHAT"
session_id = "web_test_001"
} | ConvertTo-Json
Invoke-RestMethod -Uri "http://127.0.0.1:3010/api/public/complaints" `
-Method POST -ContentType "application/json" -Body $complaintBody
# Cek status pengaduan publik
Invoke-RestMethod "http://127.0.0.1:3010/api/public/complaints/LAP-xxx/check" `
-Method POST -ContentType "application/json" `
-Body '{"session_id":"web_test_001","channel":"WEBCHAT"}'
Superadmin Endpoints
# List villages
Invoke-RestMethod "http://127.0.0.1:3010/api/superadmin/villages" -Headers $SA_H
# List village admins
Invoke-RestMethod "http://127.0.0.1:3010/api/superadmin/village-admins" -Headers $SA_H
# System health
Invoke-RestMethod "http://127.0.0.1:3010/api/superadmin/system-health" -Headers $SA_H
# AI wallets
Invoke-RestMethod "http://127.0.0.1:3010/api/superadmin/ai-wallets" -Headers $SA_H
# LLM check
Invoke-RestMethod "http://127.0.0.1:3010/api/superadmin/llm-check" -Headers $SA_H
Statistics
# Overview statistik
Invoke-RestMethod "http://127.0.0.1:3010/api/statistics/overview" -Headers $VA_H
# Realtime summary dashboard
Invoke-RestMethod "http://127.0.0.1:3010/api/dashboard/realtime-summary" -Headers $VA_H
# AI usage stats
Invoke-RestMethod "http://127.0.0.1:3010/api/statistics/ai-usage" -Headers $VA_H
Cek Database Langsung
$env:PGPASSWORD = "dbgovconnect2026"
# Laporan terbaru
psql -h 127.0.0.1 -U govconnect -d govconnect -c `
"SELECT complaint_id, status, kategori, is_urgent, village_id FROM cases.complaints ORDER BY created_at DESC LIMIT 10;"
# Service requests terbaru
psql -h 127.0.0.1 -U govconnect -d govconnect -c `
"SELECT request_number, status, village_id FROM cases.service_requests ORDER BY created_at DESC LIMIT 10;"
# Notification logs
psql -h 127.0.0.1 -U govconnect -d govconnect -c `
"SELECT notification_type, status, channel, created_at FROM notification.notification_logs ORDER BY created_at DESC LIMIT 10;"
# AI grounding mismatches
psql -h 127.0.0.1 -U govconnect -d govconnect -c `
"SELECT mismatch_kind, status, village_id, detected_at FROM ai.ai_runtime_grounding_mismatches ORDER BY detected_at DESC LIMIT 10;"
# Outbox events pending
psql -h 127.0.0.1 -U govconnect -d govconnect -c `
"SELECT routing_key, status, attempt_count, created_at FROM cases.event_outbox WHERE status != 'sent' ORDER BY created_at DESC LIMIT 10;"
Cek RabbitMQ
# Cek queues via management API
Invoke-RestMethod "http://127.0.0.1:15672/api/queues/govconnect" `
-Headers @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("admin:genfityrabbitmq")) }
aibot88