dPdigiPsycho API
v1Draf · prototipe
Daftar isi ▾
  • Ringkasan
  • Autentikasi
  • Konvensi
    • Format error
    • Rate limit
    • Idempotency
    • Paginasi
  • Endpoint
    • POST /oauth/token
    • POST /test-tokens
    • GET /sessions
    • GET /sessions/{id}
    • POST /sessions/{id}/cancel
    • GET /sessions/{id}/report
    • GET /vacancies
    • GET /vacancies/{id}/ranking
    • POST /webhooks/test
  • Webhook
    • Payload
    • Verifikasi tanda tangan
  • Status sesi
  • Aturan kuota
  • Daftar kode error
  • Ringkasan
  • Autentikasi
  • Konvensi
    • Format error
    • Rate limit
    • Idempotency
    • Paginasi
  • Endpoint
    • POST /oauth/token
    • POST /test-tokens
    • GET /sessions
    • GET /sessions/{id}
    • POST /sessions/{id}/cancel
    • GET /sessions/{id}/report
    • GET /vacancies
    • GET /vacancies/{id}/ranking
    • POST /webhooks/test
  • Webhook
    • Payload
    • Verifikasi tanda tangan
  • Status sesi
  • Aturan kuota
  • Daftar kode error

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

API ini adalah mock fungsional untuk menguji alur integrasi. Bentuk JSON menjadi draf awal spesifikasi produksi dan dapat berubah. Norma & narasi pada laporan masih DUMMY.

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>.

  1. POST /oauth/token dengan APP_ID + APP_SECRET.
  2. Simpan access_token di memori; minta token baru bila menerima 401 atau mendekati expires_in.
  3. 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:

json
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_LIMITED dengan header Retry-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:

json
"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)).

ParameterTipeKeterangan
grant_typestringWajib. Harus client_credentials.
client_idstringAPP_ID tenant.
client_secretstringAPP_SECRET tenant.
curl
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"
200 OK
{
  "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.

ParameterTipeKeterangan
Idempotency-KeyheaderWajib. Lihat bagian Idempotency.
vacancy_idstringWajib. ID lowongan berstatus OPEN (lihat GET /vacancies).
applicant.namestringWajib, 2–120 karakter.
applicant.emailstringWajib, email valid.
applicant.phonestringWajib. 4 digit terakhir dipakai untuk verifikasi identitas pelamar.
applicant.external_refstring?ID pelamar di sistem Anda; dipakai untuk filter applicant_ref dan dikirim di webhook.
validity_daysinteger?1–30. Bawaan: pengaturan lowongan (mis. 7 hari).
curl
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
  }'
201 Created
{
  "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

ParameterTipeKeterangan
vacancy_idstring?Filter per lowongan.
statusstring?Satu atau beberapa status dipisah koma, mis. REPORT_READY,FLAGGED.
applicant_refstring?Filter per external_ref pelamar.
validitystring?VALID | CAUTION | FLAGGED (hanya sesi yang laporannya siap).
updated_sinceISO 8601?Hanya sesi yang berubah sejak waktu ini — cocok untuk sinkronisasi berkala.
sortstring?created_desc (bawaan) | fit_desc.
page, per_pageinteger?Paginasi, per_page maks. 100.
curl
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"
200 OK
{
  "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.

200 OK (dipersingkat)
{
  "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).

200 OK
{
  "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.

200 OK
{
  "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)."
  }
}
409 Conflict
{
  "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.

200 OK
{
  "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.

200 OK
{
  "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.

201 Created
{
  "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:

ParameterTipeKeterangan
SESSION_STATUS_CHANGEDeventSetiap perubahan status sesi (terbit, dibuka, persetujuan, mulai, dikirim, kedaluwarsa, dibatalkan, skoring gagal).
REPORT_READYeventLaporan 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

SESSION_STATUS_CHANGED
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"
  }
}
REPORT_READY
{
  "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.

  1. Ambil body mentah (byte persis seperti diterima) — jangan parse lalu stringify ulang.
  2. Hitung HMAC dan bandingkan dengan perbandingan waktu-konstan.
  3. Tolak bila selisih t dengan jam server > 5 menit (cegah replay).
Node.js (Express)
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);
});
Prototipe: bila jam simulasi dimajukan (alat demo admin), nilai t mengikuti jam simulasi sehingga cek toleransi 5 menit akan gagal. Nonaktifkan cek waktu saat menguji dengan prototipe.

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:

StatusArtiTransisi berikutnya
ISSUEDToken terbitOPENED, EXPIRED, CANCELLED
OPENEDDibukaCONSENTED, EXPIRED, CANCELLED
CONSENTEDPersetujuan diberikanIN_PROGRESS, EXPIRED, CANCELLED
IN_PROGRESSSedang mengerjakanSUBMITTED, CANCELLED
SUBMITTEDDikirimSCORED, SCORING_FAILED
SCORING_FAILEDSkoring gagalSCORED, SCORING_FAILED
SCOREDDiskorREPORT_READY, FLAGGED
REPORT_READYLaporan siapSCORED
FLAGGEDLaporan siap — ditandaiSCORED
EXPIREDKedaluwarsa— (akhir)
CANCELLEDDibatalkan— (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 respons POST /test-tokens.

Daftar kode error

HTTPcodeKeterangan
400invalid_requestParameter OAuth tidak lengkap (grant_type, client_id, client_secret).
400unsupported_grant_typegrant_type selain client_credentials.
400INVALID_JSONBody bukan JSON yang valid.
400INVALID_PARAMETERQuery parameter di luar nilai yang diizinkan (lihat field parameter).
400IDEMPOTENCY_KEY_REQUIREDHeader Idempotency-Key tidak dikirim pada POST /test-tokens.
401invalid_clientAPP_ID/APP_SECRET salah, kredensial dicabut, atau tenant ditangguhkan.
401UNAUTHORIZEDAccess token tidak ada, salah, atau kedaluwarsa (15 menit).
402QUOTA_EXCEEDEDKuota tes tenant habis. Token tidak diterbitkan.
403TENANT_SUSPENDEDTenant ditangguhkan oleh admin platform.
404NOT_FOUNDSesi/lowongan tidak ada atau milik tenant lain (isolasi tenant).
404VACANCY_NOT_FOUNDvacancy_id tidak ditemukan di tenant Anda.
409IDEMPOTENCY_CONFLICTIdempotency-Key sama dipakai untuk body berbeda.
409REPORT_NOT_READYLaporan belum tersedia; field current_status berisi status saat ini.
409INVALID_STATEAksi tidak sah untuk status sesi saat ini (mis. membatalkan sesi yang sudah dikirim).
422VALIDATION_ERRORBody tidak valid; field details berisi daftar {field, message}.
422VACANCY_NOT_OPENLowongan berstatus DRAFT atau CLOSED.
422WEBHOOK_NOT_CONFIGUREDURL webhook tenant belum diatur (POST /webhooks/test).
429RATE_LIMITEDMelebihi batas permintaan; tunggu sesuai header Retry-After.
500INTERNAL_ERRORKesalahan server. Sertakan request_id saat menghubungi dukungan.

digiPsycho API v1 · draf prototipe · seluruh contoh data fiktif.