Langsung ke konten
Sursa Developers

Waktu dan format

JSON dan teks

  • Isi permintaan dan isi respons berupa JSON dalam UTF-8, dengan Content-Type: application/json. Unggahan file memakai multipart/form-data.
  • Nama field dan nilai enum ditulis dalam snake_case: next_retry_at, index_failed.
  • Pesan error dan teks API dalam bahasa Inggris. Teks yang Anda tulis, seperti judul kartu, dikembalikan sebagaimana Anda menulisnya, dalam bahasa apa pun.

Waktu

Setiap waktu adalah timestamp RFC 3339 dalam UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Field yang lebih baru memakai bentuk pendek dengan Z, seperti di atas.
  • Beberapa field yang sudah ada sebelumnya memakai bentuk 2026-10-24T10:00:00.123456+00:00, dengan hingga enam digit pecahan detik. Itu adalah saat yang sama dalam UTC. Urai kedua bentuk dengan parser RFC 3339 standar; jangan membandingkan timestamp sebagai string.
  • Setiap field yang namanya berakhiran _at adalah timestamp.

Waktu yang Anda kirim harus menyertakan offset zona waktu, baik Z maupun offset numerik seperti +02:00. Waktu tanpa offset bersifat ambigu dan mengembalikan 422 dengan kode validation.failed. Sursa mengonversi setiap waktu yang diterimanya ke UTC.

const since = new Date(Date.now() - 24 * 3600 * 1000).toISOString(); // "2026-10-23T10:00:00.000Z"

Dalam query string, + harus ditulis sebagai %2B, atau tanda itu dibaca sebagai spasi. Lakukan URL-encode pada nilai waktu, atau pakai Z.

Tanggal, durasi, dan jumlah

JenisBentukContoh
Tanggal tanpa waktuYYYY-MM-DD, dalam field yang berakhiran _date"due_date": "2026-11-01"
DurasiBilangan bulat, dengan satuan di nama field"interval_days": 90, "timeout_seconds": 30
JumlahBilangan bulat, dalam field yang berakhiran _count"part_count": 12
Benar atau salahBoolean, dinamai dengan kata sifat tanpa is_"active": true, "sensitive": false

Jumlah uang

Jumlah uang dalam respons keuangan berupa string desimal, seperti "1250.00", tidak pernah bilangan floating point, agar presisi tidak hilang. Mata uang adalah field tersendiri dengan kode ISO 4217, seperti "EUR". Urai jumlah uang dengan tipe desimal di bahasa pemrograman Anda.

ID

ID berupa string atau bilangan bulat, tergantung objeknya. Lihat ID objek.

Enum

Field dengan kumpulan nilai tetap, seperti status, berupa string. Setiap enum dalam respons dapat mendapat nilai baru di versi berikutnya: perlakukan nilai yang tidak Anda kenal sebagai “lainnya”. Lihat Versi dan kompatibilitas.

Null dan field yang tidak ada

  • null berarti “tidak ada nilai”: kartu tanpa penanggung jawab memiliki "owner_id": null.
  • Field dapat tidak ada dalam respons jika tidak berlaku untuk objek ini atau permintaan ini. Referensi API menandai field mana yang selalu ada.
  • Dalam PATCH, field yang tidak Anda sertakan mempertahankan nilainya. Kirim null untuk mengosongkan field jika referensi menyatakan bahwa null diizinkan.