Documentation — HaidarApis

Try the API

GET200

/api/v1/health

example.javascript

1const res = await fetch("https://api.haidarxd.my.id/api/v1/user?id=123", {
2  headers: {
3    Authorization: "Bearer YOUR_API_KEY",
4    "Content-Type": "application/json",
5  },
6});
7
8if (!res.ok) throw new Error("Request failed: " + res.status);
9
10const data = await res.json();
11console.log(data);

Getting Started

#getting-started

Kirim request pertamamu dalam waktu kurang dari satu menit.

Semua endpoint berada di bawah base URL https://api.haidarxd.my.id/api/v1 dan hanya menerima koneksi HTTPS.

Setiap response dikembalikan dalam format JSON dengan struktur konsisten berisi data, status, dan meta.

first-request.sh

1curl "https://api.haidarxd.my.id/api/v1/health" \
2  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

#authentication

Gunakan Bearer token atau header X-API-Key.

Setiap request wajib menyertakan API key. Kamu bisa menaruhnya pada header Authorization sebagai Bearer token, atau pada header X-API-Key.

Untuk integrasi sisi server yang membutuhkan sesi pengguna, gunakan JWT access token yang diperoleh dari endpoint /auth/token dengan refresh token rotation.

auth.sh

1# Opsi 1 — Bearer token
2curl "https://api.haidarxd.my.id/api/v1/user?id=123" \
3  -H "Authorization: Bearer sk_live_9f2b7c4a8d1e"
4
5# Opsi 2 — X-API-Key header
6curl "https://api.haidarxd.my.id/api/v1/user?id=123" \
7  -H "X-API-Key: sk_live_9f2b7c4a8d1e"

API Key

#api-key

Buat, batasi scope, dan cabut key kapan saja.

API key dibuat dari Dashboard → API Keys. Key hanya ditampilkan sekali karena kami menyimpan hash-nya saja.

Setiap key dapat memiliki scope (read, write, admin), rate limit khusus, dan tanggal kedaluwarsa.

Field	Type	Description
name	string	Label key agar mudah dikenali
scopes	string[]	read \| write \| admin
rate_limit	integer	Request per menit untuk key ini
expires_at	datetime	Opsional, key otomatis nonaktif

Headers

#headers

Header wajib dan opsional pada setiap request.

Selain header autentikasi, kamu dapat mengirim header opsional untuk idempotency dan tracing.

Header	Required	Description
Authorization	Yes	Bearer <api_key>
Content-Type	For POST/PUT	application/json
X-Request-Id	No	ID unik untuk tracing lintas layanan
Idempotency-Key	No	Mencegah duplikasi pada request tulis

Response

#response

Struktur envelope yang konsisten di seluruh endpoint.

Field data berisi payload utama, status menandakan hasil operasi, dan meta memuat informasi teknis seperti latency serta versi API.

response.json

1{
2  "data": {
3    "id": 123,
4    "name": "Haidar",
5    "plan": "pro"
6  },
7  "status": "success",
8  "meta": {
9    "latency_ms": 38,
10    "cached": false,
11    "version": "v1",
12    "request_id": "req_8f2b7c4a"
13  }
14}

Errors

#errors

Kode status HTTP standar dengan pesan deskriptif.

Setiap error mengembalikan objek error berisi code, message, dan opsional details untuk validasi per-field.

Status	Code	Meaning
400	bad_request	Parameter tidak valid atau kurang
401	unauthorized	API key hilang atau tidak valid
403	forbidden	Scope key tidak mencukupi
404	not_found	Endpoint atau resource tidak ditemukan
429	rate_limited	Melebihi batas request
500	internal_error	Kesalahan pada sisi server

Rate Limit

#rate-limit

Sliding window per API key, IP, dan plan.

Setiap response menyertakan header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset.

Ketika limit terlampaui, API mengembalikan 429 beserta waktu tunggu dalam detik pada header Retry-After.

rate-limit-headers

1X-RateLimit-Limit: 600
2X-RateLimit-Remaining: 584
3X-RateLimit-Reset: 1754392800
4Retry-After: 23

Pagination

#pagination

Cursor dan offset pagination untuk koleksi besar.

Gunakan parameter limit dan cursor untuk koleksi besar. Response menyertakan next_cursor bila masih ada halaman berikutnya.

pagination.sh

1curl "https://api.haidarxd.my.id/api/v1/logs?limit=50&cursor=eyJpZCI6MTIzfQ" \
2  -H "Authorization: Bearer YOUR_API_KEY"

SDK

#sdk

Client resmi untuk JavaScript, Python, dan Go.

SDK menangani retry, backoff, rate limit awareness, dan typing otomatis dari OpenAPI spec.

install.sh

1npm install @haidarapis/sdk
2pip install haidarapis-sdk
3go get github.com/HAIDAR-XDD/sdk-go

Status & Health

#status

Endpoint health check untuk monitoring uptime.

Endpoint /health tidak membutuhkan autentikasi dan cocok untuk uptime checker eksternal.

health.json

1{
2  "status": "operational",
3  "regions": ["sgp", "fra", "iad"],
4  "uptime_30d": 99.99,
5  "version": "v1.4.0"
6}

API Reference

Endpoint Explorer