DEV Community

Cover image for วิธีใช้ BigCommerce API: คู่มือพัฒนาสำหรับเชื่อมต่ออีคอมเมิร์ซ
Thanawat Wongchai
Thanawat Wongchai

Posted on • Originally published at apidog.com

วิธีใช้ BigCommerce API: คู่มือพัฒนาสำหรับเชื่อมต่ออีคอมเมิร์ซ

#api #backend #tutorial #webdev

สรุปย่อ

BigCommerce APIs ช่วยให้คุณจัดการผลิตภัณฑ์, คำสั่งซื้อ, ลูกค้า และการดำเนินงานของร้านค้าได้ด้วยโปรแกรม คุณจะยืนยันตัวตนด้วย API tokens (สำหรับฝั่งเซิร์ฟเวอร์) หรือ OAuth (สำหรับแอป) เรียกใช้ REST endpoints ที่ api.bigcommerce.com และจัดการ webhooks เพื่อรับการอัปเดตแบบเรียลไทม์ สำหรับการทดสอบ ให้ใช้ Apidog เพื่อบันทึกการเรียกใช้ API ของคุณ ตรวจสอบความถูกต้องของคำตอบ และแชร์คอลเลกชันกับทีมของคุณ

ทดลองใช้ Apidog วันนี้

บทนำ

BigCommerce ขับเคลื่อนร้านค้าออนไลน์กว่า 60,000 แห่ง แต่ละแห่งต้องการการผสานรวมที่กำหนดเอง เช่น การซิงค์สต็อกสินค้า, การประมวลผลคำสั่งซื้อ, การจัดการลูกค้า, การจัดการการชำระเงิน นั่นคือที่มาของ API

แพลตฟอร์มนี้มี API สามประเภท: Storefront API (headless commerce), Management API (การดำเนินงานแบ็กเอนด์) และ Payments API (ธุรกรรม) นักพัฒนาส่วนใหญ่ทำงานกับ Management API ซึ่งจัดการผลิตภัณฑ์, คำสั่งซื้อ, ลูกค้า และทุกสิ่งที่เกิดขึ้นเบื้องหลัง

การเรียนรู้ไม่ได้ยาก แต่เอกสารประกอบอาจดูเยอะเกินไป คุณจะพบว่าตัวเองต้องกระโดดไปมาระหว่างเอกสารการยืนยันตัวตน, การอ้างอิง API และ คู่มือ webhook เพียงเพื่อให้งานง่ายๆ เสร็จสมบูรณ์

คู่มือนี้เน้นสิ่งที่คุณจะใช้จริง ๆ ได้แก่ ผลิตภัณฑ์, คำสั่งซื้อ, ลูกค้า และ webhooks คุณจะได้เรียนรู้การยืนยันตัวตน รูปแบบทั่วไป และวิธีการทดสอบการผสานรวมของคุณก่อนที่จะใช้งานจริงกับร้านค้า

💡 หากคุณกำลังสร้างการผสานรวมกับ BigCommerce, Apidog จะช่วยคุณออกแบบ, ทดสอบ และจัดทำเอกสารการเรียกใช้ API เหล่านั้น บันทึกคำขอเป็นคอลเลกชัน ใช้ตัวแปรสภาพแวดล้อมสำหรับร้านค้าที่แตกต่างกัน และตรวจสอบว่าคำตอบตรงกับ schema ที่คาดไว้ Apidog จะช่วยตรวจจับข้อผิดพลาดก่อนที่จะส่งผลกระทบต่อลูกค้าจริง

ทดสอบ BigCommerce APIs ของคุณด้วย Apidog - ฟรี

เมื่อจบคู่มือนี้ คุณจะสามารถ:

  • ตั้งค่าการยืนยันตัวตน BigCommerce ได้อย่างถูกต้อง
  • จัดการผลิตภัณฑ์, ตัวเลือกสินค้า (variants) และสต็อกสินค้า
  • ประมวลผลคำสั่งซื้อและจัดการข้อมูลลูกค้า
  • ตั้งค่า webhooks สำหรับการอัปเดตแบบเรียลไทม์
  • ทดสอบและจัดทำเอกสารการผสานรวมของคุณด้วย Apidog

การยืนยันตัวตน: การเข้าถึงร้านค้าของคุณ

BigCommerce มีวิธีการยืนยันตัวตนสองแบบขึ้นอยู่กับสิ่งที่คุณกำลังสร้าง

วิธีที่ 1: API Tokens (สำหรับการผสานรวมที่กำหนดเอง)

สำหรับสคริปต์หรือบริการที่ทำงานกับร้านค้าเดียว ใช้ API tokens

สร้างบัญชี API:

  1. ไปที่แผงควบคุมผู้ดูแลระบบของร้านค้าคุณ
  2. การตั้งค่า (Settings) → บัญชี API (API Accounts) → สร้างบัญชี API (Create API Account)
  3. เลือก “V3/V2 API Token”
  4. เลือกขอบเขตที่ต้องการ (ผลิตภัณฑ์, คำสั่งซื้อ, ลูกค้า ฯลฯ)
  5. บันทึกข้อมูลการเข้าสู่ระบบ

คุณจะได้รับ:

  • Store URL: mystore.mybigcommerce.com
  • Access Token: abc123def456...
  • Client ID: abc123...
  • Client Secret: xyz789...

ทำการเรียกใช้ครั้งแรก:

curl -X GET "https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products" \
  -H "X-Auth-Token: {access-token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"
Enter fullscreen mode Exit fullscreen mode

store-hash คือส่วนที่อยู่หลัง /stores/ ในพาธ API ของคุณ ดูได้ใน URL ผู้ดูแลระบบร้านค้าของคุณ

วิธีที่ 2: OAuth (สำหรับแอปพลิเคชันใน Marketplace)

ถ้าคุณกำลังสร้างแอปสำหรับ BigCommerce marketplace ให้ใช้ OAuth

ขั้นตอน OAuth:

  1. ผู้ใช้คลิก “ติดตั้ง” (Install) บนแอปของคุณใน marketplace
  2. BigCommerce จะเปลี่ยนเส้นทางไปยัง callback URL ของคุณพร้อมกับโค้ดยืนยันตัวตน (auth code)
  3. เซิร์ฟเวอร์ของคุณแลกเปลี่ยนโค้ดเพื่อรับ access token
  4. เก็บโทเค็นไว้ใช้เรียก API

แลกเปลี่ยนโค้ดเพื่อรับโทเค็น:

const response = await fetch('https://login.bigcommerce.com/oauth2/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    client_id: process.env.BC_CLIENT_ID,
    client_secret: process.env.BC_CLIENT_SECRET,
    redirect_uri: 'https://yourapp.com/auth/callback',
    grant_type: 'authorization_code',
    code: authCode,
    scope: 'store_v2_default store_v3_products'
  })
})

const { access_token, context } = await response.json()
// access_token คือสิ่งที่คุณใช้สำหรับการเรียกใช้ API
// context ประกอบด้วย store_hash
Enter fullscreen mode Exit fullscreen mode

ใช้โทเค็น:

curl -X GET "https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products" \
  -H "X-Auth-Token: {access-token}" \
  -H "Content-Type: application/json"
Enter fullscreen mode Exit fullscreen mode

การจัดการผลิตภัณฑ์และแค็ตตาล็อก

ผลิตภัณฑ์คือหัวใจของร้านค้า BigCommerce ทุกแห่ง V3 Catalog API จัดการผลิตภัณฑ์, ตัวเลือกสินค้า (variants), หมวดหมู่ และแบรนด์

รายการผลิตภัณฑ์ 

GET https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products
X-Auth-Token: {token}
Accept: application/json
Enter fullscreen mode Exit fullscreen mode

การตอบสนอง:

{
  "data": [
    {
      "id": 174,
      "name": "Plain T-Shirt",
      "type": "physical",
      "sku": "PLAIN-T",
      "price": 29.99,
      "sale_price": 24.99,
      "inventory_level": 150,
      "inventory_tracking": "product",
      "is_visible": true,
      "categories": [23, 45],
      "brand_id": 12
    }
  ],
  "meta": {
    "pagination": {
      "total": 500,
      "count": 50,
      "page": 1,
      "per_page": 50
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

สร้างผลิตภัณฑ์ 

POST https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products
X-Auth-Token: {token}
Content-Type: application/json

{
  "name": "Premium Hoodie",
  "type": "physical",
  "sku": "HOODIE-PREM",
  "price": 79.99,
  "description": "Premium cotton blend hoodie",
  "weight": 1.5,
  "width": 20,
  "height": 28,
  "depth": 2,
  "inventory_level": 100,
  "inventory_tracking": "product",
  "is_visible": true,
  "categories": [23]
}
Enter fullscreen mode Exit fullscreen mode

อัปเดตตัวเลือกสินค้า

ผลิตภัณฑ์ที่มีตัวเลือก (ขนาด, สี) มีตัวเลือกสินค้า (variants) ตัวเลือกสินค้าแต่ละรายการสามารถมี SKU, ราคา และสต็อกสินค้าของตัวเอง

PUT https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products/{product-id}/variants/{variant-id}
X-Auth-Token: {token}
Content-Type: application/json

{
  "sku": "HOODIE-PREM-BLK-M",
  "price": 79.99,
  "inventory_level": 50,
  "option_values": [
    {
      "option_display_name": "Color",
      "label": "Black"
    },
    {
      "option_display_name": "Size",
      "label": "Medium"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

จัดการสต็อกสินค้า 

PUT https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products/{product-id}
X-Auth-Token: {token}
Content-Type: application/json

{
  "inventory_level": 75
}
Enter fullscreen mode Exit fullscreen mode

หรืออัปเดตสต็อกสินค้าตัวเลือก:

PUT https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products/{product-id}/variants/{variant-id}
Content-Type: application/json

{
  "inventory_level": 25
}
Enter fullscreen mode Exit fullscreen mode

คำสั่งซื้อและการจัดการการจัดส่ง

Orders V2 API จัดการการสร้าง, การอัปเดต และการจัดการการจัดส่งคำสั่งซื้อ

รายการคำสั่งซื้อ 

GET https://api.bigcommerce.com/stores/{store-hash}/v2/orders
X-Auth-Token: {token}
Accept: application/json
Enter fullscreen mode Exit fullscreen mode

การตอบสนอง:

[
  {
    "id": 115,
    "status": "Awaiting Fulfillment",
    "status_id": 11,
    "customer_id": 45,
    "date_created": "2026-03-24T10:30:00+00:00",
    "subtotal_ex_tax": 149.99,
    "total_inc_tax": 162.49,
    "items_total": 2,
    "items_shipped": 0,
    "shipping_address": {
      "first_name": "John",
      "last_name": "Doe",
      "street_1": "123 Main St",
      "city": "Austin",
      "state": "Texas",
      "zip": "78701",
      "country": "United States"
    }
  }
]
Enter fullscreen mode Exit fullscreen mode

ดูรายละเอียดคำสั่งซื้อ 

GET https://api.bigcommerce.com/stores/{store-hash}/v2/orders/{order-id}
X-Auth-Token: {token}
Enter fullscreen mode Exit fullscreen mode

ดูผลิตภัณฑ์ในคำสั่งซื้อ 

GET https://api.bigcommerce.com/stores/{store-hash}/v2/orders/{order-id}/products
X-Auth-Token: {token}
Enter fullscreen mode Exit fullscreen mode

อัปเดตสถานะคำสั่งซื้อ 

PUT https://api.bigcommerce.com/stores/{store-hash}/v2/orders/{order-id}
X-Auth-Token: {token}
Content-Type: application/json

{
  "status_id": 12
}
Enter fullscreen mode Exit fullscreen mode

ID สถานะทั่วไป:

  • 0: ไม่สมบูรณ์ (Incomplete)
  • 11: รอการจัดส่ง (Awaiting Fulfillment)
  • 12: เสร็จสมบูรณ์ (Completed)
  • 5: ยกเลิก (Cancelled)
  • 4: คืนเงิน (Refunded)

สร้างการจัดส่ง (fulfillment) 

POST https://api.bigcommerce.com/stores/{store-hash}/v2/orders/{order-id}/shipments
X-Auth-Token: {token}
Content-Type: application/json

{
  "tracking_number": "1Z999AA10123456784",
  "carrier": "UPS",
  "shipping_method": "UPS Ground",
  "items": [
    {
      "order_product_id": 234,
      "quantity": 1
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

ลูกค้าและการแบ่งกลุ่ม

Customers V3 API จัดการข้อมูลลูกค้า, ที่อยู่ และกลุ่มลูกค้า

รายการลูกค้า 

GET https://api.bigcommerce.com/stores/{store-hash}/v3/customers
X-Auth-Token: {token}
Accept: application/json
Enter fullscreen mode Exit fullscreen mode

การตอบสนอง:

{
  "data": [
    {
      "id": 45,
      "email": "john.doe@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "company": "Acme Corp",
      "phone": "512-555-1234",
      "customer_group_id": 1,
      "notes": "VIP customer",
      "tax_exempt_category": "",
      "date_created": "2025-11-15T09:30:00+00:00",
      "date_modified": "2026-03-20T14:22:00+00:00"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

สร้างลูกค้า 

POST https://api.bigcommerce.com/stores/{store-hash}/v3/customers
X-Auth-Token: {token}
Content-Type: application/json

{
  "email": "jane.smith@example.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "phone": "512-555-5678",
  "customer_group_id": 2
}
Enter fullscreen mode Exit fullscreen mode

อัปเดตลูกค้า 

PUT https://api.bigcommerce.com/stores/{store-hash}/v3/customers/{customer-id}
X-Auth-Token: {token}
Content-Type: application/json

{
  "notes": "Repeat customer - priority support",
  "customer_group_id": 3
}
Enter fullscreen mode Exit fullscreen mode

Webhooks สำหรับการอัปเดตแบบเรียลไทม์

Webhooks แจ้งเตือนแอปของคุณเมื่อมีเหตุการณ์เกิดขึ้นในร้านค้า ไม่ต้อง polling, BigCommerce จะส่งข้อมูลไปยัง endpoints ของคุณโดยตรง

สร้าง webhook 

POST https://api.bigcommerce.com/stores/{store-hash}/v3/hooks
X-Auth-Token: {token}
Content-Type: application/json

{
  "scope": "store/order/created",
  "destination": "https://yourapp.com/webhooks/orders",
  "is_active": true
}
Enter fullscreen mode Exit fullscreen mode

ขอบเขตที่พร้อมใช้งาน:

  • store/order/created - คำสั่งซื้อใหม่ถูกสร้างขึ้น
  • store/order/updated - สถานะคำสั่งซื้อมีการเปลี่ยนแปลง
  • store/order/archived - คำสั่งซื้อถูกเก็บถาวร
  • store/product/created - ผลิตภัณฑ์ถูกเพิ่ม
  • store/product/updated - ผลิตภัณฑ์ถูกแก้ไข
  • store/product/deleted - ผลิตภัณฑ์ถูกลบ
  • store/customer/created - ลูกค้าใหม่
  • store/inventory/updated - สต็อกสินค้ามีการเปลี่ยนแปลง

ตรวจสอบลายเซ็น webhook

BigCommerce เซ็น webhook คุณควรตรวจสอบลายเซ็นทุกครั้ง:

import crypto from 'crypto'

function verifyWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex')

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  )
}

app.post('/webhooks/orders', (req, res) => {
  const signature = req.headers['x-bc-webhook-signature']
  const payload = JSON.stringify(req.body)

  if (!verifyWebhook(payload, signature, process.env.BC_CLIENT_SECRET)) {
    return res.status(401).send('Invalid signature')
  }

  // Process the webhook
  console.log('Order created:', req.body.data.id)
  res.status(200).send('OK')
})
Enter fullscreen mode Exit fullscreen mode

การทดสอบ BigCommerce API ด้วย Apidog

BigCommerce API ต้องการ header และการยืนยันตัวตนที่ถูกต้อง การทดสอบด้วย curl ทีละคำขออาจเสียเวลา ใช้ Apidog เพื่อเร่งกระบวนการ

ตัวอย่าง Apidog

1. การตั้งค่าสภาพแวดล้อม

สร้างสภาพแวดล้อมสำหรับแต่ละร้านค้า:

# Production Store
STORE_HASH: abc123
ACCESS_TOKEN: xyz789
BASE_URL: https://api.bigcommerce.com/stores/abc123

# Staging Store
STORE_HASH: staging456
ACCESS_TOKEN: staging_token
BASE_URL: https://api.bigcommerce.com/stores/staging456
Enter fullscreen mode Exit fullscreen mode

2. สคริปต์ก่อนการเรียกใช้

เพิ่ม header การยืนยันตัวตนโดยอัตโนมัติ:

pm.request.headers.add({
  key: 'X-Auth-Token',
  value: pm.environment.get('ACCESS_TOKEN')
})
pm.request.headers.add({
  key: 'Accept',
  value: 'application/json'
})
Enter fullscreen mode Exit fullscreen mode

3. ตรวจสอบความถูกต้องของคำตอบ

ทดสอบว่าผลิตภัณฑ์มีฟิลด์ที่จำเป็น:

pm.test('Products have required fields', () => {
  const response = pm.response.json()
  response.data.forEach(product => {
    pm.expect(product).to.have.property('id')
    pm.expect(product).to.have.property('name')
    pm.expect(product).to.have.property('price')
    pm.expect(product.price).to.be.above(0)
  })
})

pm.test('Pagination works', () => {
  const response = pm.response.json()
  pm.expect(response.meta.pagination).to.have.property('total')
  pm.expect(response.meta.pagination.page).to.eql(1)
})
Enter fullscreen mode Exit fullscreen mode

ทดสอบ BigCommerce API ด้วย Apidog - ฟรี

ข้อผิดพลาดที่พบบ่อยและการแก้ไข

401 ไม่ได้รับอนุญาต (Unauthorized)

สาเหตุ: Access token ไม่ถูกต้องหรือไม่มีอยู่

วิธีแก้ไข:

  1. ตรวจสอบ header X-Auth-Token
  2. เช็คว่าโทเค็นยังไม่ถูกเพิกถอน
  3. ตรวจสอบขอบเขตของบัญชี API

403 ห้ามเข้าถึง (Forbidden)

สาเหตุ: โทเค็นถูกต้องแต่ไม่มีขอบเขตที่จำเป็น

วิธีแก้ไข:

  1. ตรวจสอบสิทธิ์ของบัญชี API ของคุณ
  2. เพิ่มขอบเขตที่ขาดหายไป (ผลิตภัณฑ์, คำสั่งซื้อ ฯลฯ)
  3. สร้างโทเค็นใหม่ด้วยสิทธิ์ที่ขยายเพิ่ม

404 ไม่พบ (Not Found)

สาเหตุ: Endpoint ผิด หรือทรัพยากรไม่มีอยู่จริง

วิธีแก้ไข:

  1. ยืนยันว่า store hash ถูกต้อง
  2. ตรวจสอบเวอร์ชัน API ใน URL (v2 กับ v3)
  3. ตรวจสอบให้แน่ใจว่า resource ID มีอยู่จริง

429 คำขอมากเกินไป (Too Many Requests)

สาเหตุ: เกินขีดจำกัดการเรียกใช้ (Rate limit exceeded)

วิธีแก้ไข: BigCommerce มีขีดจำกัดแต่ละ endpoint ผลิตภัณฑ์: 10,000 คำขอ/ชม. คำสั่งซื้อ: 30,000 คำขอ/ชม. ตรวจสอบ header X-Rate-Limit-Remaining และใช้กลยุทธ์ backoff

async function callWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fn()
    if (response.status === 429) {
      const retryAfter = response.headers.get('X-Rate-Limit-Reset')
      await new Promise(r => setTimeout(r, retryAfter * 1000))
    } else {
      return response
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

422 เอนทิตีไม่สามารถประมวลผลได้ (Unprocessable Entity)

สาเหตุ: ข้อมูลไม่ผ่าน validation

วิธีแก้ไข: ตรวจสอบ response เพื่อดูรายละเอียด BigCommerce จะส่งคืน error เฉพาะ

{
  "errors": {
    "price": "Price must be greater than zero",
    "sku": "SKU already exists"
  }
}
Enter fullscreen mode Exit fullscreen mode

ทางเลือกและการเปรียบเทียบ

คุณสมบัติ BigCommerce Shopify WooCommerce
การกำหนดเวอร์ชัน API V2 และ V3 REST และ GraphQL REST
ขีดจำกัดการเรียกใช้ 10K-30K/ชม. 2/นาที (leaky bucket) ขึ้นกับโฮสต์
Webhooks มี มี มี (ปลั๊กอิน)
GraphQL ไม่มี มี ไม่มี
คุณภาพ SDK ดี ยอดเยี่ยม PHP เท่านั้น
หลายร้านค้า (Multi-store) มี ไม่มี ไม่มี

V3 API ของ BigCommerce มีความสอดคล้องมากกว่าวิธีการที่กระจัดกระจายของ Shopify แต่ GraphQL API ของ Shopify ให้ความยืดหยุ่นมากขึ้นสำหรับการสอบถามที่ซับซ้อน

กรณีการใช้งานจริง

การซิงค์สต็อกสินค้าหลายช่องทาง: แบรนด์ขายสินค้าบน BigCommerce, Amazon และร้านค้าจริง ใช้ Products API เพื่อซิงค์สต็อกสินค้าในทุกช่องทาง ป้องกัน oversell และ Apidog ช่วยทดสอบ endpoint การซิงค์ก่อนใช้งานจริง

การจัดการคำสั่งซื้ออัตโนมัติ: บริษัทกล่องสมัครสมาชิกใช้ webhooks เพื่อ trigger การจัดส่งเมื่อมีคำสั่งซื้อใหม่ Orders API อัปเดตหมายเลขติดตาม โกดังรับข้อมูลสินค้าเพื่อจัดส่งโดยอัตโนมัติผ่าน webhook handler

การแบ่งกลุ่มลูกค้า: เว็บไซต์อีคอมเมิร์ซใช้ Customers API เพื่อแบ่งกลุ่มผู้ซื้อ ลูกค้า VIP ถูกเพิ่มในกลุ่มพิเศษพร้อมราคาพิเศษ การผสานรวมนี้ทำงานทุกสัปดาห์ผ่าน scheduled job

สรุป

สิ่งที่คุณควรนำไปใช้:

  • การยืนยันตัวตนใช้ API tokens (ผสานรวมแบบง่าย) หรือ OAuth (แอปใน marketplace)
  • V3 Catalog API จัดการผลิตภัณฑ์และตัวเลือกสินค้า
  • V2 Orders API จัดการการประมวลผลและการจัดส่งคำสั่งซื้อ
  • V3 Customers API จัดการข้อมูลลูกค้า
  • Webhooks ส่งการอัปเดตแบบเรียลไทม์ไปยัง endpoints ของคุณ
  • ทดสอบและจัดทำเอกสารด้วย Apidog เพื่อการผสานรวมที่เชื่อถือได้

ขั้นตอนถัดไป:

  1. สร้างบัญชี API ในร้านค้า BigCommerce ของคุณ
  2. ทำการเรียก API ครั้งแรกเพื่อแสดงรายการผลิตภัณฑ์
  3. ตั้งค่า webhook สำหรับการสร้างคำสั่งซื้อ
  4. บันทึกการเรียก API ของคุณใน Apidog
  5. สร้างการผสานรวมของคุณ

ทดสอบ BigCommerce API ด้วย Apidog - ฟรี

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

ความแตกต่างระหว่าง V2 และ V3 API คืออะไร?

V3 เป็น API ที่ใหม่กว่าและสอดคล้องกันมากกว่า ใช้สำหรับผลิตภัณฑ์, หมวดหมู่, แบรนด์ และลูกค้า V2 จัดการคำสั่งซื้อที่ยังไม่ได้ย้าย คุณจะต้องใช้ทั้งสองเวอร์ชันในการผสานรวมส่วนใหญ่

จะรับ store hash ได้อย่างไร?

ดูใน URL ผู้ดูแลระบบ BigCommerce ของคุณ: https://store-abc123.mybigcommerce.com/manage ส่วน abc123 คือ store hash ของคุณ หรือตรวจสอบในตั้งค่าบัญชี API

ใช้ API บนร้านค้าทดลองได้หรือไม่?

ได้ ร้านค้าทดลองของ BigCommerce มีการเข้าถึง API เต็มรูปแบบ เหมาะสำหรับ dev และ test

ขีดจำกัดการเรียก API คืออะไร?

ขึ้นอยู่กับ endpoint ผลิตภัณฑ์: 10,000 คำขอ/ชม. คำสั่งซื้อ: 30,000 คำขอ/ชม. ดู X-Rate-Limit-Remaining ใน response header

จัดการ pagination อย่างไร?

ใช้ query parameter page และ limit ขีดจำกัดเริ่มต้นคือ 50 ตรวจสอบ meta.pagination ใน response และวนซ้ำจนดึงครบ

let allProducts = []
let page = 1

while (true) {
  const response = await fetch(
    `${baseUrl}/v3/catalog/products?page=${page}&limit=100`,
    { headers: { 'X-Auth-Token': token } }
  )
  const data = await response.json()
  allProducts.push(...data.data)

  if (page >= data.meta.pagination.total_pages) break
  page++
}
Enter fullscreen mode Exit fullscreen mode

อัปโหลดรูปภาพผลิตภัณฑ์ผ่าน API ได้หรือไม่?

ได้ ใช้ endpoint:

POST https://api.bigcommerce.com/stores/{store-hash}/v3/catalog/products/{product-id}/images
Content-Type: application/json

{
  "image_url": "https://example.com/image.jpg",
  "is_thumbnail": true
}
Enter fullscreen mode Exit fullscreen mode

จัดการสกุลเงินและร้านค้าหลายแห่ง?

ร้านค้า BigCommerce มีสกุลเงินพื้นฐาน หลายสกุลเงินจัดการใน Storefront ไม่ใช่ API ถ้าต้องการหลายร้านค้า ให้สร้าง API account แยกและใช้ environment แยกใน Apidog

ถ้า endpoint webhook ล่ม?

BigCommerce จะ retry webhooks ที่ล้มเหลวด้วย exponential backoff หลัง 5 ครั้งที่ล้มเหลวใน 24 ชม. webhook จะถูกปิดใช้งาน ตรวจสอบ endpoint และตั้ง alert เมื่อมี error

ทดลองใช้ Apidog วันนี้ เพื่อการทดสอบและจัดการ BigCommerce API อย่างมืออาชีพ!

Top comments (0)