เอกสาร B2B

B2B API – เรียกข้อมูลคำสั่งซื้อและสินค้าโดยอัตโนมัติ

REST-API ของเราพร้อมให้บริการแก่ลูกค้าทุกรายที่มีบัญชีลูกค้า และช่วยให้สามารถเรียกข้อมูลคำสั่งซื้อและสินค้าโดยอัตโนมัติและรวมเข้ากับระบบของคุณเองได้

vpn_key เปิดการเข้าถึง API ในบัญชี หน้าลูกค้าธุรกิจ

การยืนยันตัวตน

คำขอ API ทั้งหมดต้องใช้ API-Key ที่ถูกต้องซึ่งส่งไปพร้อมกับ HTTP-Header การเข้าถึง API ผูกกับบัญชีลูกค้าของคุณและพร้อมให้บริการแก่บัญชีลูกค้าโดยทั่วไป

info คุณไม่ต้องยื่นคำขอ B2B แยกต่างหาก: เข้าสู่ระบบด้วยบัญชีลูกค้าของคุณ เปิดแท็บ API และสร้าง API-Key ของคุณที่นั่น ไปยังการเข้าถึง API →

รูปแบบ Header

HTTP Request Header

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

ตัวอย่างด้วย 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

Endpoints ทั้งหมดสัมพันธ์กับ Base URL ต่อไปนี้:

Base URL

https://artumos.com/api/v1

คำตอบทั้งหมดจะถูกส่งกลับเป็น JSON (Content-Type: application/json).

Rate Limits

Plan	คำขอ / นาที	คำขอ / วัน
บัญชีลูกค้า	60	5.000
ขีดจำกัดที่ขยายเพิ่ม	ตามคำขอ	ตามคำขอ

เมื่อเกินขีดจำกัดจะมีการส่งกลับ HTTP 429 Too Many Requests Header Retry-After มีระยะเวลารอเป็นวินาที

รหัสข้อผิดพลาด

HTTP-Code	ความหมาย
`200 OK`	คำขอสำเร็จ
`400 Bad Request`	พารามิเตอร์ไม่ถูกต้อง
`401 Unauthorized`	API-Key ขาดหายไปหรือไม่ถูกต้อง
`403 Forbidden`	ไม่มีสิทธิ์สำหรับทรัพยากรนี้
`404 Not Found`	ไม่พบทรัพยากร
`429 Too Many Requests`	เกิน Rate Limit
`500 Internal Server Error`	ข้อผิดพลาดของเซิร์ฟเวอร์ – โปรดติดต่อฝ่ายสนับสนุน

รูปแบบ Response ของข้อผิดพลาด

JSON

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

Endpoint: คำสั่งซื้อ

GET /api/v1/orders คำสั่งซื้อทั้งหมดของบัญชี

Parameter	ประเภท	คำอธิบาย
`page`	integer	หน้า (ค่าเริ่มต้น: 1)
`per_page`	integer	รายการต่อหน้า (สูงสุด 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} เรียกคำสั่งซื้อเดียว

Endpoint: ข้อมูลสินค้าและคำสั่งซื้อ

GET /api/v1/orders/{order_id}/codes ข้อมูลสินค้าทั้งหมดของคำสั่งซื้อหนึ่ง

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} เรียกข้อมูลสินค้าเดียว

warning ข้อมูลสินค้าและคำสั่งซื้ออาจใช้ได้เฉพาะภายในขอบเขตของคำสั่งซื้อและข้อมูลผู้ขายที่เกี่ยวข้องเท่านั้น การส่งต่อในทางที่ผิดอาจฝ่าฝืนเงื่อนไขการใช้งาน

Endpoint: สินค้า

GET /api/v1/products เรียกแคตตาล็อกสินค้า

Parameter	ประเภท	คำอธิบาย
`category`	string	กรองตาม Slug ของหมวดหมู่
`in_stock`	boolean	เฉพาะสินค้าที่มีจำหน่าย
`page`	integer	หน้า

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 ช่วยให้รับการแจ้งเตือนแบบเรียลไทม์ได้เมื่อมีการจัดเตรียมคำสั่งซื้อหรือ Code Webhook-URL สามารถบันทึกไว้ในบัญชีลูกค้าได้

Events ที่มีให้ใช้งาน

Event	คำอธิบาย
`order.paid`	คำสั่งซื้อได้รับการชำระเงินแล้ว
`codes.delivered`	Code ได้รับการจัดเตรียมแล้ว
`order.refunded`	คำสั่งซื้อได้รับการคืนเงินแล้ว

Webhook Payload

POST – Webhook-Endpoint ของคุณ

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

ยืนยันลายเซ็นด้วย Webhook-Secret ของคุณ: HMAC-SHA256(payload, webhook_secret)

คำถามที่พบบ่อย

ใครสามารถใช้ B2B API ได้?

ลูกค้าทุกรายที่มีบัญชีลูกค้าสามารถใช้การเข้าถึง API ได้ เข้าสู่ระบบในบัญชีลูกค้าของคุณและใช้ API-Key ที่เกี่ยวข้องสำหรับคำขอที่ผ่านการยืนยันตัวตน

คำตอบมีรูปแบบใด?

คำตอบทั้งหมดจะถูกส่งกลับเป็น JSON Root-Object จะมีเสมอ success: true/false รวมถึงอย่างใดอย่างหนึ่ง data หรือ error.

ฉันสามารถวางคำสั่งซื้อผ่าน API ได้หรือไม่?

ในเวอร์ชันแรก API ใช้สำหรับการเรียกคำสั่งซื้อ ข้อมูลคำสั่งซื้อ และข้อมูลสินค้า Endpoints ของคำสั่งซื้อแบบเขียนจะเปิดใช้งานแยกต่างหากทันทีที่พร้อมใช้งาน

มีสภาพแวดล้อม Sandbox หรือไม่?

มี Sandbox สามารถเปิดใช้งานในบัญชีลูกค้าในแท็บ „การเข้าถึง API“ และผูกกับ API-Key ที่เกี่ยวข้องโดยตรง