Memulai

Xmltronik API memberikan akses katalog produk melalui API partner. Akun partner Anda sudah siap digunakan setelah aktivasi.

Base URL

Prasyarat: pendaftaran OpenAPI

Sebelum akun partner dibuat, ajukan pendaftaran OpenAPI ke XMLTRONIK melalui tim kami. Pengajuan ini diperlukan agar akses API partner dapat disiapkan. Setelah pengajuan disetujui, XMLTRONIK membuat akun partner dan mengirim email aktivasi ke alamat email yang Anda daftarkan.

1. Aktivasi akun

Buka tautan aktivasi yang dikirim ke email partner Anda. Tautan berlaku 24 jam. Set password, lalu login di /partner.

2. Siapkan kredensial

Di dashboard partner, buat partner key pair. Simpan private key di sisi Anda dan unggah public key ke platform. Lengkapi callback URL dan whitelist IP sesuai kebutuhan.

Dashboard juga menampilkan platform public key untuk verifikasi callback. Client secret tersedia di halaman yang sama dan bisa dilihat ulang atau dirotasi.

Perintah pembuatan key pair dan detail formatnya ada di Pembuatan Signature.

3. Minta access token

POST /openapi/v1.0/access-token/b2b
X-CLIENT-KEY: <client_id>
X-TIMESTAMP: <ISO-8601>
X-SIGNATURE: <SHA256withRSA(clientId|X-TIMESTAMP)>

{ "grantType": "client_credentials" }

Signature dibuat dengan partner private key. Access token berlaku maksimal 15 menit. Langkah lengkap, contoh nilai, dan penanganan error ada di Pembuatan Signature.

4. Ambil katalog produk

GET /openapi/v1.0/products
Authorization: Bearer <accessToken>
X-PARTNER-ID: <client_id>
X-EXTERNAL-ID: <random string>
CHANNEL-ID: WEB
X-TIMESTAMP: <ISO-8601>
X-SIGNATURE: HMAC_SHA512(METHOD:path:token:sha256(body):timestamp)

Response berisi katalog produk yang tersedia untuk akun partner Anda, dikelompokkan per operator.