Dokumentasi REST API
Integrasikan psikotes digiPsycho ke sistem rekrutmen Anda (mis. DigiHR): terbitkan test token untuk pelamar, terima webhook saat status berubah, lalu ambil hasil dan laporan PDF.
Draf spesifikasi — prototipe
Ringkasan
- Base URL:
https://digipsycho.iweka-internal.my.id/api/v1 - Format: JSON (UTF-8). Kunci JSON memakai snake_case; waktu dalam ISO 8601 UTC.
- Setiap respons membawa header
X-Request-Id; cantumkan nilai ini saat melaporkan masalah. - Semua data otomatis dibatasi pada tenant pemilik access token. ID milik tenant lain selalu dijawab 404.
- Alur umum: token akses → terbitkan test token → kirim URL ke pelamar → webhook REPORT_READY → ambil laporan.
Autentikasi
Gunakan OAuth2 client_credentials. Admin platform memberikan APP_ID dan APP_SECRET (secret hanya ditampilkan sekali; simpan di secret manager). Tukarkan keduanya dengan access token berumur 15 menit, lalu kirim sebagai Authorization: Bearer <access_token>.
POST /oauth/tokendengan APP_ID + APP_SECRET.- Simpan access_token di memori; minta token baru bila menerima 401 atau mendekati expires_in.
- Saat secret di-rotate, secret lama masih diterima 24 jam (masa tenggang). Revoke berlaku seketika.
Konvensi
Format error
Semua error memakai amplop yang sama dengan status HTTP yang sesuai:
HTTP/1.1 422 Unprocessable Entity
X-Request-Id: req_5f0c2a9e1b7d4c33
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Data permintaan tidak valid.",
"request_id": "req_5f0c2a9e1b7d4c33",
"details": [
{ "field": "applicant.email", "message": "Format email tidak valid" }
]
}
}Rate limit
POST /oauth/token: 10 permintaan/menit per alamat IP.- Endpoint lain: 60 permintaan/menit per access token (jendela geser 60 detik).
- Respons sukses membawa
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset(detik). - Bila terlampaui: HTTP 429
RATE_LIMITEDdengan headerRetry-After(detik). Lakukan backoff, jangan langsung mengulang.
Idempotency
POST /test-tokens wajib menyertakan header Idempotency-Key (string unik, mis. UUID atau <id_lamaran>-<id_lowongan>, maks. 200 karakter). Ini mencegah token ganda — dan kuota terpotong dua kali — saat jaringan putus lalu permintaan diulang.
- Key + body sama → respons sesi yang sama, HTTP 200 dengan header
Idempotent-Replayed: true. Kuota tidak berkurang lagi. - Key sama + body berbeda → HTTP 409
IDEMPOTENCY_CONFLICT. - Key bersifat per tenant dan disimpan tanpa batas waktu di prototipe (produksi: 30 hari).
Paginasi
Endpoint daftar menerima page (mulai 1) dan per_page (1–100, bawaan 20) serta mengembalikan meta:
"meta": { "page": 1, "per_page": 20, "total": 37, "total_pages": 2 }Endpoint
Minta access token
POST/api/v1/oauth/token
Menerima body application/x-www-form-urlencoded atau application/json. Kredensial juga boleh dikirim lewat HTTP Basic (base64(client_id:client_secret)).
| Parameter | Tipe | Keterangan |
|---|---|---|
| grant_type | string | Wajib. Harus client_credentials. |
| client_id | string | APP_ID tenant. |
| client_secret | string | APP_SECRET tenant. |
curl -X POST https://digipsycho.iweka-internal.my.id/api/v1/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=$DIGIPSYCHO_APP_ID" \
-d "client_secret=$DIGIPSYCHO_APP_SECRET"{
"access_token": "at_Qm9zc2EgbW9jayB0b2tlbiBkaWdpUHN5Y2hv",
"token_type": "Bearer",
"expires_in": 900
}Error: 400 invalid_request / unsupported_grant_type, 401 invalid_client, 429 RATE_LIMITED.
Terbitkan test token
POST/api/v1/test-tokens
Menerbitkan token tes sekali pakai untuk satu pelamar pada satu lowongan. Kuota dicek dan dipesan secara atomik. Pelamar membuka test_url dari HP atau laptop.
| Parameter | Tipe | Keterangan |
|---|---|---|
| Idempotency-Key | header | Wajib. Lihat bagian Idempotency. |
| vacancy_id | string | Wajib. ID lowongan berstatus OPEN (lihat GET /vacancies). |
| applicant.name | string | Wajib, 2–120 karakter. |
| applicant.email | string | Wajib, email valid. |
| applicant.phone | string | Wajib. 4 digit terakhir dipakai untuk verifikasi identitas pelamar. |
| applicant.external_ref | string? | ID pelamar di sistem Anda; dipakai untuk filter applicant_ref dan dikirim di webhook. |
| validity_days | integer? | 1–30. Bawaan: pengaturan lowongan (mis. 7 hari). |
curl -X POST https://digipsycho.iweka-internal.my.id/api/v1/test-tokens \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: DHR-APL-2291-vac_nkmadm01" \
-d '{
"vacancy_id": "vac_nkmadm01",
"applicant": {
"name": "Rina Kartika",
"email": "rina.kartika@mail.example",
"phone": "081234567890",
"external_ref": "DHR-APL-2291"
},
"validity_days": 7
}'{
"session_id": "ses_8c1f0a2b3d4e",
"status": "ISSUED",
"test_token": "Xk2pQ9vT7mLw4sYb",
"test_url": "https://digipsycho.iweka-internal.my.id/t/Xk2pQ9vT7mLw4sYb",
"expires_at": "2026-11-26T08:15:00.000Z",
"vacancy_id": "vac_nkmadm01",
"applicant_ref": "DHR-APL-2291",
"quota": { "available": 41 }
}Ulangan dengan key yang sama → 200 OK + Idempotent-Replayed: true, body identik. Error: 400, 402 QUOTA_EXCEEDED, 403 TENANT_SUSPENDED, 404 VACANCY_NOT_FOUND, 409 IDEMPOTENCY_CONFLICT, 422 VALIDATION_ERROR / VACANCY_NOT_OPEN.
Daftar sesi
GET/api/v1/sessions
| Parameter | Tipe | Keterangan |
|---|---|---|
| vacancy_id | string? | Filter per lowongan. |
| status | string? | Satu atau beberapa status dipisah koma, mis. REPORT_READY,FLAGGED. |
| applicant_ref | string? | Filter per external_ref pelamar. |
| validity | string? | VALID | CAUTION | FLAGGED (hanya sesi yang laporannya siap). |
| updated_since | ISO 8601? | Hanya sesi yang berubah sejak waktu ini — cocok untuk sinkronisasi berkala. |
| sort | string? | created_desc (bawaan) | fit_desc. |
| page, per_page | integer? | Paginasi, per_page maks. 100. |
curl "https://digipsycho.iweka-internal.my.id/api/v1/sessions?vacancy_id=vac_nkmadm01&status=REPORT_READY,FLAGGED&sort=fit_desc&per_page=10" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"data": [
{
"id": "ses_8c1f0a2b3d4e",
"status": "REPORT_READY",
"status_label": "Laporan siap",
"issued_via": "API",
"vacancy": { "id": "vac_nkmadm01", "code": "NKM-ADM-01", "title": "Staf Administrasi Keuangan" },
"applicant": {
"id": "cand_1a2b3c4d5e6f",
"name": "Rina Kartika",
"email": "rina.kartika@mail.example",
"phone": "081234567890",
"external_ref": "DHR-APL-2291"
},
"test_url": "https://digipsycho.iweka-internal.my.id/t/Xk2pQ9vT7mLw4sYb",
"created_at": "2026-11-19T08:15:00.000Z",
"expires_at": "2026-11-26T08:15:00.000Z",
"updated_at": "2026-11-19T10:02:41.000Z",
"progress": { "modules_done": 6, "modules_total": 6 },
"fit": { "method": "WD", "score": 72, "range": [65, 79], "below_minimum": [] },
"validity": "VALID",
"report_url": "https://digipsycho.iweka-internal.my.id/api/v1/sessions/ses_8c1f0a2b3d4e/report"
}
],
"meta": { "page": 1, "per_page": 10, "total": 1, "total_pages": 1 }
}fit, validity, dan report_url bernilai null sampai laporan siap. test_url bernilai null untuk sesi EXPIRED/CANCELLED.
Detail sesi
GET/api/v1/sessions/{id}
Sama seperti item daftar, ditambah timeline, status per modul, penghitung proctoring, dan Fit Score untuk semua metode.
{
"data": {
"id": "ses_8c1f0a2b3d4e",
"status": "IN_PROGRESS",
"...": "field yang sama dengan daftar",
"timeline": {
"opened_at": "2026-11-19T08:20:11.000Z",
"consented_at": "2026-11-19T08:21:40.000Z",
"consent_version": "consent-2026.11-draft",
"started_at": "2026-11-19T08:24:02.000Z",
"submitted_at": null, "scored_at": null, "report_ready_at": null,
"cancelled_at": null, "cancel_reason": null, "expired_at": null
},
"modules": [
{ "module": "COG", "label": "Penalaran", "status": "DONE", "started_at": "2026-11-19T08:24:02.000Z", "finished_at": "2026-11-19T08:35:10.000Z" },
{ "module": "PERS", "label": "Gaya Kerja", "status": "IN_PROGRESS", "started_at": "2026-11-19T08:36:00.000Z", "finished_at": null }
],
"proctoring": { "tab_switches": 1, "paste_attempts": 0, "offline_events": 0, "device_switches": 0 },
"fit_all_methods": null
}
}Batalkan sesi
POST/api/v1/sessions/{id}/cancel
Hanya untuk sesi yang belum dikirim (ISSUED, OPENED, CONSENTED, IN_PROGRESS). Bila tes belum dimulai, kuota yang dipesan dikembalikan. Body: { "reason": "Pelamar mengundurkan diri" } (3–500 karakter).
{
"data": { "id": "ses_8c1f0a2b3d4e", "status": "CANCELLED", "...": "..." },
"quota": { "available": 42 }
}Error: 404, 409 INVALID_STATE (mis. sesi sudah SUBMITTED), 422 VALIDATION_ERROR.
Ringkasan laporan + URL PDF
GET/api/v1/sessions/{id}/report
Tersedia saat status REPORT_READY atau FLAGGED. URL PDF adalah signed URL berumur 5 menit — ambil endpoint ini lagi untuk URL baru. Sesi FLAGGED tetap memiliki laporan, dengan peringatan validitas.
{
"data": {
"session_id": "ses_8c1f0a2b3d4e",
"status": "REPORT_READY",
"applicant": { "name": "Rina Kartika", "external_ref": "DHR-APL-2291" },
"vacancy": { "id": "vac_nkmadm01", "code": "NKM-ADM-01", "title": "Staf Administrasi Keuangan" },
"computed_at": "2026-11-19T10:02:40.000Z",
"primary_method": "WD",
"fit": {
"WD": {
"score": 72, "range": [65, 79], "person_job": 74, "person_organization": 66,
"below_minimum": [],
"contributions": [
{ "construct": "C", "weight": 5, "fit": 0.91, "candidate_t": 58.2, "target_t": 60 }
]
},
"PC": { "score": 69, "range": [61, 77], "...": "..." },
"TH": { "score": 72, "range": [65, 79], "...": "..." }
},
"scales": [
{ "scale": "COG", "label": "Kemampuan Kognitif Umum", "t": 56.3, "se": 4.1, "percentile": 74, "band": "AR", "band_label": "Di atas rata-rata", "answered": 16, "total": 16 }
],
"values": { "scores": { "ACH": 8, "WC": 6, "REC": 4, "REL": 5, "SUP": 5, "IND": 2 }, "ranked": ["ACH", "WC", "REL", "SUP", "REC", "IND"] },
"culture": { "candidate": { "INNOV": 2.7, "STAB": 3.3, "...": 0 }, "correlation_with_org": 0.41 },
"validity": { "status": "VALID", "flags": [] },
"narrative": {
"summary": "Kandidat menunjukkan kecocokan yang baik dengan profil jabatan…",
"strengths": [{ "construct": "C", "title": "Kesungguhan", "text": "…" }],
"development": [{ "construct": "E", "title": "Ekstraversi", "text": "…" }],
"validity": "Tidak ditemukan indikasi pola respons yang tidak wajar…"
},
"interview_questions": [
{ "construct": "E", "question": "Ceritakan pengalaman Anda membangun hubungan…", "why": "…" }
],
"versions": { "engine": "engine-0.1.0-proto", "norm": "norm-DUMMY-2026.11", "template": "tpl-DRAFT-0.1" },
"pdf": {
"hr_url": "https://digipsycho.iweka-internal.my.id/api/reports/ses_8c1f0a2b3d4e/pdf?variant=hr&exp=1795082860&sig=…",
"applicant_url": "https://digipsycho.iweka-internal.my.id/api/reports/ses_8c1f0a2b3d4e/pdf?variant=applicant&exp=1795082860&sig=…",
"expires_at": "2026-11-19T10:07:40.000Z"
},
"disclaimer": "Alat bantu keputusan, bukan penentu kelulusan. Norma & narasi masih DUMMY (prototipe)."
}
}{
"error": {
"code": "REPORT_NOT_READY",
"message": "Laporan belum tersedia. Status sesi saat ini: IN_PROGRESS. Tunggu webhook REPORT_READY.",
"request_id": "req_0b9d…",
"current_status": "IN_PROGRESS"
}
}Daftar lowongan
GET/api/v1/vacancies
Filter opsional status=DRAFT|OPEN|CLOSED. Hanya lowongan OPEN yang dapat menerbitkan token.
{
"data": [
{
"id": "vac_nkmadm01",
"code": "NKM-ADM-01",
"title": "Staf Administrasi Keuangan",
"department": "Keuangan",
"location": "Jakarta Selatan",
"level": "Staf",
"status": "OPEN",
"job_family": "ADMIN",
"modules": ["COG", "PERS", "SJT", "VALUES", "CULTURE", "KRAEPELIN"],
"fit_method": "WD",
"token_validity_days": 7,
"sessions": { "total": 11, "report_ready": 7 },
"created_at": "2026-10-22T03:00:00.000Z",
"updated_at": "2026-10-22T03:00:00.000Z"
}
],
"meta": { "total": 1 }
}Ranking Fit Score per lowongan
GET/api/v1/vacancies/{id}/ranking?method=WD|PC|TH
Mengurutkan sesi berstatus REPORT_READY/FLAGGED. Bawaan method = metode lowongan. Pada TH, kandidat di bawah ambang minimum diurutkan terakhir (tidak digugurkan). Selisih skor yang rentangnya tumpang-tindih tidak bermakna.
{
"vacancy": { "id": "vac_nkmadm01", "code": "NKM-ADM-01", "...": "..." },
"method": "WD",
"data": [
{
"rank": 1,
"session_id": "ses_8c1f0a2b3d4e",
"applicant": { "name": "Rina Kartika", "external_ref": "DHR-APL-2291" },
"fit": { "method": "WD", "score": 72, "range": [65, 79], "person_job": 74, "person_organization": 66, "below_minimum": [] },
"validity": "VALID",
"status": "REPORT_READY"
}
],
"meta": { "total": 1, "note": "Rentang (range) menunjukkan ketidakpastian pengukuran; selisih skor kecil antar kandidat tidak bermakna." }
}Kirim webhook uji
POST/api/v1/webhooks/test
Mengirim event bertanda tangan ke URL webhook tenant (berisi "test": true) untuk menguji endpoint penerima Anda. Body opsional: { "event": "REPORT_READY" }. Di prototipe, pengiriman disimulasikan; URL yang mengandung “fail” menghasilkan 500.
{
"data": {
"id": "whd_3e9a1c0b7f22",
"event": "SESSION_STATUS_CHANGED",
"session_id": "ses_8c1f0a2b3d4e",
"url": "https://hris.klien.example/webhooks/digipsycho",
"status": "DELIVERED",
"attempts": 1,
"response_code": 200,
"created_at": "2026-11-19T10:10:00.000Z",
"last_attempt_at": "2026-11-19T10:10:00.000Z",
"headers": {
"X-DigiPsycho-Signature": "t=1795083000,v1=6f1c…",
"X-DigiPsycho-Event": "SESSION_STATUS_CHANGED"
},
"payload": { "id": "evt_…", "event": "SESSION_STATUS_CHANGED", "test": true, "...": "..." }
}
}Webhook
Atur URL HTTPS penerima di Portal HR (Integrasi) atau melalui admin platform. Event dikirim sebagai POST JSON:
| Parameter | Tipe | Keterangan |
|---|---|---|
| SESSION_STATUS_CHANGED | event | Setiap perubahan status sesi (terbit, dibuka, persetujuan, mulai, dikirim, kedaluwarsa, dibatalkan, skoring gagal). |
| REPORT_READY | event | Laporan siap (status REPORT_READY atau FLAGGED). Berisi Fit Score ringkas dan report_endpoint. |
Balas dengan HTTP 2xx dalam 10 detik; respons lain dianggap gagal. Produksi: retry otomatis dengan backoff eksponensial (rencana hingga 3 percobaan). Di prototipe, pengiriman ulang dilakukan admin platform, dan 3 kegagalan memicu peringatan ke admin. Event bisa datang lebih dari sekali atau tidak berurutan — gunakan id event untuk deduplikasi dan status + created_at sebagai sumber kebenaran.
Payload
POST /webhooks/digipsycho HTTP/1.1
Content-Type: application/json
X-DigiPsycho-Event: SESSION_STATUS_CHANGED
X-DigiPsycho-Signature: t=1795080000,v1=9b3c0d…
{
"id": "evt_4c2a9f0e1d3b",
"event": "SESSION_STATUS_CHANGED",
"created_at": "2026-11-19T08:24:02.000Z",
"data": {
"session_id": "ses_8c1f0a2b3d4e",
"status": "IN_PROGRESS",
"previous_status": "CONSENTED",
"applicant_ref": "DHR-APL-2291",
"vacancy_id": "vac_nkmadm01",
"vacancy_code": "NKM-ADM-01"
}
}{
"id": "evt_7d1e2f3a4b5c",
"event": "REPORT_READY",
"created_at": "2026-11-19T10:02:41.000Z",
"data": {
"session_id": "ses_8c1f0a2b3d4e",
"status": "REPORT_READY",
"previous_status": "SCORED",
"applicant_ref": "DHR-APL-2291",
"vacancy_id": "vac_nkmadm01",
"vacancy_code": "NKM-ADM-01",
"fit_score": 72,
"fit_range": [65, 79],
"validity": "VALID",
"report_endpoint": "/api/v1/sessions/ses_8c1f0a2b3d4e/report"
}
}Verifikasi tanda tangan
Header X-DigiPsycho-Signature berformat t=<unix_detik>,v1=<hex>, dengan v1 = HMAC_SHA256(webhook_secret, t + "." + raw_body). Webhook secret (whsec_…) berbeda dari APP_SECRET.
- Ambil body mentah (byte persis seperti diterima) — jangan parse lalu stringify ulang.
- Hitung HMAC dan bandingkan dengan perbandingan waktu-konstan.
- Tolak bila selisih t dengan jam server > 5 menit (cegah replay).
import crypto from "node:crypto";
import express from "express";
const WEBHOOK_SECRET = process.env.DIGIPSYCHO_WEBHOOK_SECRET; // whsec_...
export function verifySignature(rawBody, header, secret, toleranceSec = 300) {
if (!header) return false;
const parts = Object.fromEntries(header.split(",").map((p) => p.trim().split("=")));
const t = Number(parts.t);
if (!Number.isFinite(t) || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false;
const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const a = Buffer.from(expected, "utf8");
const b = Buffer.from(parts.v1 ?? "", "utf8");
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
const app = express();
app.post("/webhooks/digipsycho", express.raw({ type: "application/json" }), (req, res) => {
const raw = req.body.toString("utf8");
if (!verifySignature(raw, req.get("X-DigiPsycho-Signature"), WEBHOOK_SECRET)) {
return res.status(400).send("invalid signature");
}
const event = JSON.parse(raw);
// dedupe on event.id, then enqueue processing; respond fast
res.sendStatus(204);
});Status sesi
Alur utama: ISSUED → OPENED → CONSENTED → IN_PROGRESS → SUBMITTED → SCORED → REPORT_READY. Cabang: EXPIRED (token lewat masa berlaku sebelum mulai), CANCELLED, FLAGGED (laporan tetap dibuat dengan peringatan validitas), SCORING_FAILED (retry otomatis, tanpa skoring manual). Transisi yang sah:
| Status | Arti | Transisi berikutnya |
|---|---|---|
| ISSUED | Token terbit | OPENED, EXPIRED, CANCELLED |
| OPENED | Dibuka | CONSENTED, EXPIRED, CANCELLED |
| CONSENTED | Persetujuan diberikan | IN_PROGRESS, EXPIRED, CANCELLED |
| IN_PROGRESS | Sedang mengerjakan | SUBMITTED, CANCELLED |
| SUBMITTED | Dikirim | SCORED, SCORING_FAILED |
| SCORING_FAILED | Skoring gagal | SCORED, SCORING_FAILED |
| SCORED | Diskor | REPORT_READY, FLAGGED |
| REPORT_READY | Laporan siap | SCORED |
| FLAGGED | Laporan siap — ditandai | SCORED |
| EXPIRED | Kedaluwarsa | — (akhir) |
| CANCELLED | Dibatalkan | — (akhir) |
REPORT_READY/FLAGGED → SCORED hanya terjadi saat admin platform menjalankan hitung ulang (replay) setelah pembaruan norma/template; versi lama tetap tersimpan.
Aturan kuota
- 1 kuota = 1 sesi tes. Kuota diberikan oleh admin platform per tenant.
- Saat token terbit, 1 kuota dipesan (atomik — aman dari permintaan bersamaan). Bila tidak ada kuota tersedia → 402
QUOTA_EXCEEDED. - Saat pelamar mulai mengerjakan (IN_PROGRESS), kuota yang dipesan menjadi terpakai.
- Bila token kedaluwarsa atau dibatalkan sebelum dimulai, kuota dikembalikan. Sesi yang dibatalkan setelah mulai tetap memakai kuota.
- Sisa kuota:
tersedia = diberikan − dipesan − terpakai; dikembalikan pada responsPOST /test-tokens.
Daftar kode error
| HTTP | code | Keterangan |
|---|---|---|
| 400 | invalid_request | Parameter OAuth tidak lengkap (grant_type, client_id, client_secret). |
| 400 | unsupported_grant_type | grant_type selain client_credentials. |
| 400 | INVALID_JSON | Body bukan JSON yang valid. |
| 400 | INVALID_PARAMETER | Query parameter di luar nilai yang diizinkan (lihat field parameter). |
| 400 | IDEMPOTENCY_KEY_REQUIRED | Header Idempotency-Key tidak dikirim pada POST /test-tokens. |
| 401 | invalid_client | APP_ID/APP_SECRET salah, kredensial dicabut, atau tenant ditangguhkan. |
| 401 | UNAUTHORIZED | Access token tidak ada, salah, atau kedaluwarsa (15 menit). |
| 402 | QUOTA_EXCEEDED | Kuota tes tenant habis. Token tidak diterbitkan. |
| 403 | TENANT_SUSPENDED | Tenant ditangguhkan oleh admin platform. |
| 404 | NOT_FOUND | Sesi/lowongan tidak ada atau milik tenant lain (isolasi tenant). |
| 404 | VACANCY_NOT_FOUND | vacancy_id tidak ditemukan di tenant Anda. |
| 409 | IDEMPOTENCY_CONFLICT | Idempotency-Key sama dipakai untuk body berbeda. |
| 409 | REPORT_NOT_READY | Laporan belum tersedia; field current_status berisi status saat ini. |
| 409 | INVALID_STATE | Aksi tidak sah untuk status sesi saat ini (mis. membatalkan sesi yang sudah dikirim). |
| 422 | VALIDATION_ERROR | Body tidak valid; field details berisi daftar {field, message}. |
| 422 | VACANCY_NOT_OPEN | Lowongan berstatus DRAFT atau CLOSED. |
| 422 | WEBHOOK_NOT_CONFIGURED | URL webhook tenant belum diatur (POST /webhooks/test). |
| 429 | RATE_LIMITED | Melebihi batas permintaan; tunggu sesuai header Retry-After. |
| 500 | INTERNAL_ERROR | Kesalahan server. Sertakan request_id saat menghubungi dukungan. |
digiPsycho API v1 · draf prototipe · seluruh contoh data fiktif.