XPlor3
REST API

Mengenal REST API

Base URL, autentikasi, format request dan respons, serta cara menguji kunci pertamamu.

REST API XPlor3 adalah API yang sama yang dipakai studio. Endpoint, validasi, harga, dan aturan pengembalian kreditnya tidak berbeda: kunci API cukup menggantikan sesi login.

Base URL

https://api.xplor3.space/v1

Semua endpoint di dokumentasi ini relatif terhadap alamat itu.

Autentikasi

Kirim kunci API di header Authorization setiap request:

Authorization: Bearer xpk_kunci_kamu

Request tanpa kunci, atau dengan kunci yang salah, dicabut, atau kedaluwarsa, dijawab 401 UNAUTHORIZED. Memulai generate butuh akun dengan email terverifikasi; kalau belum, jawabannya 403 EMAIL_UNVERIFIED.

Hanya dari server

Panggil API dari backend, skrip, atau server milikmu. Kunci yang dikirim dari kode di peramban pengguna bisa dibaca siapa pun yang membuka halamanmu.

Uji kunci pertamamu

curl https://api.xplor3.space/v1/wallet \
  -H "Authorization: Bearer $XPLOR3_API_KEY"

Jawaban yang berhasil berisi saldomu dan 20 catatan kredit terakhir:

{
  "balance": 120.4,
  "ledger": [
    {
      "id": "cm...",
      "delta": -9.6,
      "reason": "JOB_DEBIT",
      "jobId": "cm...",
      "orderId": null,
      "createdAt": "2026-10-23T08:12:44.120Z"
    }
  ]
}

Format

  • Request dan respons JSON, dengan header Content-Type: application/json untuk body. Pengecualiannya unggahan berkas multipart.
  • Kredit ditulis sebagai angka desimal, misalnya 9.6.
  • Waktu dalam ISO 8601 UTC, misalnya 2026-10-23T08:12:44.120Z.
  • Bahasa pesan error mengikuti header Accept-Language: en untuk bahasa Inggris, selain itu bahasa Indonesia.
  • Daftar yang panjang dipaginasi dengan limit (maksimal 50) dan cursor. Jawabannya memuat items dan nextCursor; kirim nextCursor sebagai cursor untuk halaman berikutnya sampai nilainya null.

Langkah berikutnya

Di halaman ini