DevelopersHubungkan aplikasi, marketplace, dan sistem bisnis Anda dengan layanan transportasi dan delivery Nujek melalui Partner API.
Partner API dirancang untuk membantu Anda mengirim order, melacak perjalanan, dan mengelola komunikasi customer dari satu API yang konsisten.
RESTful, predictable, dan mudah diintegrasikan.
HMAC-SHA256 pada setiap request.
SDK, webhook, dan contoh lengkap.
Mulai dengan kredensial test dan siapkan integrasi dasar Anda melalui empat langkah sederhana.
Buat akun partner di Dashboard Nujek dan lengkapi profil bisnis.
Dapatkan client key, API secret, dan webhook secret dummy untuk sandbox.
Gunakan SDK resmi atau request HTTP langsung sesuai kebutuhan tim Anda.
Register customer, lalu lanjutkan dengan pricing preview dan order.
const customer = await client.register({
name: 'Budi',
email: 'budi@example.com',
phone: '081234567890',
});Setiap request ke Partner API wajib menyertakan empat header. Secret tidak pernah dikirim langsung melalui jaringan.
X-Client-Key: pk_test_demo_123
X-Timestamp: 1726279200
X-Nonce: 8f1c2d...
X-Signature: sha256=9d4a...Hash body dengan SHA-256, lalu susun canonical string berurutan: timestamp, nonce, HTTP method, path + query, dan body hash. Gunakan API secret untuk membuat HMAC-SHA256.
1726279200
8f1c2d...
POST
/api/client/orders
sha256(body)Semua endpoint menggunakan base URL https://api.nujek.id dan response JSON yang konsisten.
api.nujek.id/api/client/registerMendaftarkan customer baru ke ekosistem Nujek.
{
"name": "Budi Santoso",
"email": "budi@example.com",
"phone": "081234567890"
}{
"data": {
"uuid": "cus_01h9...",
"name": "Budi Santoso",
"status": "active"
}
}const result = await client.request('POST', '/api/client/register');/api/client/pricing/previewMelihat estimasi harga sebelum membuat order.
?service_id=1&origin_latitude=-7.25&origin_longitude=112.76&destination_latitude=-7.26&destination_longitude=112.78{
"data": { "estimated_fare": 18500, "currency": "IDR" }
}const result = await client.request('GET', '/api/client/pricing/preview');/api/client/servicesMendapatkan daftar layanan Nujek yang tersedia.
No body required{
"data": [{ "id": 1, "name": "Nujek Ride" }]
}const result = await client.request('GET', '/api/client/services');/api/client/nearby-driversMencari driver aktif di sekitar titik pickup.
?latitude=-7.250445&longitude=112.768845&radius=5{
"data": [{ "driver_uuid": "drv_01...", "distance_km": 0.8 }]
}const result = await client.request('GET', '/api/client/nearby-drivers');/api/client/geocoding/reverseMengubah koordinat menjadi alamat yang mudah dibaca.
{
"latitude": -7.250445,
"longitude": 112.768845
}{
"data": { "address": "Surabaya, Jawa Timur" }
}const result = await client.request('POST', '/api/client/geocoding/reverse');/api/client/routing/distanceMenghitung jarak dan estimasi durasi perjalanan.
{
"origin": { "latitude": -7.25, "longitude": 112.76 },
"destination": { "latitude": -7.26, "longitude": 112.78 }
}{
"data": { "distance_m": 2140, "duration_s": 480 }
}const result = await client.request('POST', '/api/client/routing/distance');/api/client/ordersMembuat order baru untuk customer.
{
"customer_uuid": "cus_01h9...",
"service_id": 1,
"routes": [{ "latitude": -7.25, "longitude": 112.76 }]
}{
"data": { "order_uuid": "ord_01h9...", "status": "PENDING" }
}const result = await client.request('POST', '/api/client/orders');/api/client/ordersMengambil daftar order milik partner.
?status=finished&page=1&limit=20{
"data": [], "meta": { "page": 1, "total": 0 }
}const result = await client.request('GET', '/api/client/orders');/api/client/orders/{order_uuid}Melihat detail dan status order tertentu.
No body required{
"data": { "order_uuid": "ord_01h9...", "status": "FINISHED" }
}const result = await client.request('GET', '/api/client/orders/{order_uuid}');/api/client/orders/{order_uuid}/cancelMembatalkan order sesuai aturan pembatalan.
{ "reason": "customer_request" }{ "data": { "status": "CANCELLED" } }const result = await client.request('POST', '/api/client/orders/{order_uuid}/cancel');/api/client/orders/{order_uuid}/review-driverMengirim rating dan ulasan untuk driver.
{ "rating": 5, "comment": "Perjalanan nyaman" }{ "data": { "review_uuid": "rev_01..." } }const result = await client.request('POST', '/api/client/orders/{order_uuid}/review-driver');/api/client/reviewsMengirim feedback tentang pengalaman integrasi aplikasi.
{ "rating": 5, "message": "API sangat mudah digunakan" }{ "data": { "received": true } }const result = await client.request('POST', '/api/client/reviews');/api/client/orders/{order_uuid}/chat/customer_driver/messagesMengambil riwayat chat customer dan driver.
?page=1&limit=50{ "data": [{ "message": "Saya sudah di lobby" }] }const result = await client.request('GET', '/api/client/orders/{order_uuid}/chat/customer_driver/messages');/api/client/orders/{order_uuid}/chat/customer_driver/messagesMengirim pesan teks ke percakapan order.
{ "message": "Driver sudah sampai?" }{ "data": { "message_uuid": "msg_01..." } }const result = await client.request('POST', '/api/client/orders/{order_uuid}/chat/customer_driver/messages');/api/client/orders/{order_uuid}/chat/customer_driver/readMenandai pesan percakapan sebagai sudah dibaca.
{ "message_uuids": ["msg_01..."] }{ "data": { "updated": 1 } }const result = await client.request('POST', '/api/client/orders/{order_uuid}/chat/customer_driver/read');/api/client/orders/{order_uuid}/chat/customer_driver/imagesMengirim gambar ke percakapan customer dan driver.
multipart/form-data
file: receipt.png{ "data": { "image_url": "https://cdn.nujek.id/..." } }const result = await client.request('POST', '/api/client/orders/{order_uuid}/chat/customer_driver/images');Booking order memudahkan customer merencanakan perjalanan dengan waktu pickup yang sudah ditentukan.
{
"customer_uuid": "customer-uuid",
"client_request_id": "request-uuid",
"service_id": 1,
"sub_service_id": 1,
"payment_method_id": 1,
"regency_id": "7171",
"booking_at": "2026-09-14T10:00:00+08:00",
"routes": [
{ "latitude": -7.250445, "longitude": 112.768845, "address": "Pickup" },
{ "latitude": -7.260000, "longitude": 112.780000, "address": "Tujuan" }
]
}BOOKING.BOOKING_ACCEPTED.Terima update status order tanpa polling. Verifikasi raw body sebelum memproses event apa pun.
X-Webhook-Id: wh_01h9...
X-Webhook-Timestamp: 1726279200
X-Webhook-Signature: sha256=...import { parseWebhook, verifyWebhook } from '@nujek/sdk';
const valid = verifyWebhook({
webhookSecret: process.env.CLIENT_WEBHOOK_SECRET,
timestamp: req.headers['x-webhook-timestamp'],
deliveryId: req.headers['x-webhook-id'],
rawBody,
signature: req.headers['x-webhook-signature'],
});
if (!valid) { res.writeHead(401).end(); return; }
const event = parseWebhook(rawBody);chat.messageorder lifecycleorder.createdorder lifecycledriver.acceptedreal-time updateorder.finishedreal-time updateorder.cancelledreal-time updateorder.sos_createdreal-time updateWebhook best practice. Verifikasi signature menggunakan raw body, gunakan X-Webhook-Id sebagai idempotency key, balas HTTP 2xx setelah event diterima, dan siapkan retry handling untuk delivery yang gagal.
SDK resmi menangani detail repetitif supaya Anda bisa fokus membangun pengalaman terbaik untuk customer.
Integrasi TypeScript-friendly untuk backend modern.
npm install github:Nujek/sdk-nujek-node#v0.6.0Client ringan dengan dukungan context dan net/http.
go get github.com/Nujek/sdk-nujek-goSDK Python belum tersedia dan sedang kami siapkan.
Gunakan HTTP status dan error code untuk membuat fallback yang jelas di aplikasi Anda.
{
"message": "Validation failed",
"errors": {
"email": ["invalid email"]
}
}{
"error": {
"code": "INVALID_SIGNATURE",
"message": "Signature salah",
"fields": { "signature": "invalid" }
}
}Mulai integrasi Anda hari ini dan hadirkan pengalaman delivery yang lebih baik.