Dokumentasi B2B

B2B API – Ambil informasi pesanan dan produk secara otomatis

REST-API kami tersedia bagi setiap pelanggan dengan akun pelanggan dan memungkinkan untuk mengambil informasi pesanan dan produk secara otomatis serta mengintegrasikannya ke dalam sistem Anda sendiri.

vpn_key Buka akses API di akun Halaman pelanggan bisnis

Autentikasi

Semua permintaan API memerlukan API-Key yang valid, yang dikirimkan bersama dalam HTTP-Header. Akses API terikat pada akun pelanggan Anda dan pada dasarnya tersedia untuk akun pelanggan.

info Anda tidak memerlukan pengajuan B2B terpisah: Masuk dengan akun pelanggan Anda, buka tab API, dan hasilkan API-Key Anda di sana. Ke akses API →

Format header

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

Contoh dengan cURL

cURL

curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Semua endpoint relatif terhadap Base URL berikut:

Base URL

https://artumos.com/api/v1

Semua respons dikembalikan sebagai JSON (Content-Type: application/json).

Rate Limits

Plan	Permintaan / Menit	Permintaan / Hari
Akun pelanggan	60	5.000
Limit diperluas	atas permintaan	atas permintaan

Jika terlampaui, akan dikembalikan HTTP 429 Too Many Requests . Header Retry-After berisi waktu tunggu dalam detik.

Kode kesalahan

HTTP-Code	Arti
`200 OK`	Permintaan berhasil
`400 Bad Request`	Parameter tidak valid
`401 Unauthorized`	API-Key tidak ada atau tidak valid
`403 Forbidden`	Tidak ada izin untuk sumber daya ini
`404 Not Found`	Sumber daya tidak ditemukan
`429 Too Many Requests`	Rate Limit terlampaui
`500 Internal Server Error`	Kesalahan server – mohon hubungi dukungan

Format Error-Response

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endpoint: Pesanan

GET /api/v1/orders Semua pesanan dari akun

Parameter	Tipe	Deskripsi
`page`	integer	Halaman (Default: 1)
`per_page`	integer	Entri per halaman (maks. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Ambil satu pesanan

Endpoint: Informasi produk dan pesanan

GET /api/v1/orders/{order_id}/codes Semua informasi produk dari sebuah pesanan

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Ambil satu informasi produk

warning Informasi produk dan pesanan hanya boleh digunakan dalam kerangka pesanan dan keterangan penjual yang bersangkutan. Penyebaran yang menyalahgunakan dapat melanggar Ketentuan Penggunaan.

Endpoint: Produk

GET /api/v1/products Ambil katalog produk

Parameter	Tipe	Deskripsi
`category`	string	Filter slug kategori
`in_stock`	boolean	Hanya produk yang tersedia
`page`	integer	Halaman

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Webhook memungkinkan untuk menerima notifikasi waktu nyata saat pesanan atau kode disediakan. URL Webhook dapat disimpan di akun pelanggan.

Event yang tersedia

Event	Deskripsi
`order.paid`	Pesanan telah dibayar
`codes.delivered`	Kode telah disediakan
`order.refunded`	Pesanan telah dikembalikan dananya

Webhook Payload

POST – Endpoint Webhook Anda

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Verifikasi signature dengan Webhook-Secret Anda: HMAC-SHA256(payload, webhook_secret)

Pertanyaan umum

Siapa yang dapat menggunakan B2B API?

Setiap pelanggan dengan akun pelanggan dapat menggunakan akses API. Masuk ke akun pelanggan Anda dan gunakan API-Key terkait untuk permintaan yang terautentikasi.

Format apa yang dimiliki respons?

Semua respons dikembalikan sebagai JSON. Objek Root selalu berisi success: true/false serta entah data atau error.

Dapatkah saya melakukan pemesanan melalui API?

Pada versi pertama, API berfungsi untuk mengambil pesanan, informasi pesanan, dan produk. Endpoint pesanan untuk menulis akan diaktifkan secara terpisah segera setelah tersedia.

Apakah ada lingkungan Sandbox?

Ya. Sandbox dapat diaktifkan di akun pelanggan pada tab „Akses API“ dan langsung terikat pada API-Key yang bersangkutan.