Distribution API

Purpose

Use this section when this site is the upstream supplier for a Dujiao Next store. The downstream store can sync categories, products, prices, images, stock, and create purchase orders against your balance.

Downstream Settings

Signature Authentication

sign_string = METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + md5(RAW_BODY)
signature = hmac_sha256(API_SECRET, sign_string)

# GET https://mesimgo.com/api/v1/upstream/products?page=1&page_size=20
# PATH used for signing: /api/v1/upstream/products
# Do not sign with: /products or a path containing query string

curl -X POST "https://mesimgo.com/api/v1/upstream/ping" \
  -H "Dujiao-Next-Api-Key: {api_key}" \
  -H "Dujiao-Next-Timestamp: {timestamp}" \
  -H "Dujiao-Next-Signature: {signature}" \
  -H "Content-Type: application/json"

Endpoints

Product And Stock JSON

This site returns binary stock to Dujiao Next downstream stores: available is stock_status=in_stock / stock_quantity=999, unavailable is stock_status=out_of_stock / stock_quantity=0. Available means currently sellable, not reserved. The create-order result is authoritative.

{
  "ok": true,
  "items": [
    {
      "id": 31,
      "title": {"zh-CN": "Hong Kong eSIM", "en": "Hong Kong eSIM"},
      "images": ["https://mesimgo.com/uploads/example.jpg"],
      "price_amount": "6.50",
      "member_price": "6.50",
      "original_price": "8.00",
      "fulfillment_type": "auto",
      "category_id": 8,
      "skus": [
        {
          "id": 31,
          "sku_code": "31",
          "price_amount": "6.50",
          "stock_status": "in_stock",
          "stock_quantity": 999,
          "is_active": true
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Order And Fulfillment JSON

{
  "sku_id": 31,
  "quantity": 1,
  "downstream_order_no": "DN202606160001",
  "callback_url": "https://<A站域名>/api/v1/upstream/callback"
}

{
  "ok": true,
  "order_no": "APIxxxxxxxxxxxxx",
  "downstream_order_no": "DN202606160001",
  "status": "completed",
  "amount": "6.50",
  "currency": "USD",
  "fulfillment": {
    "type": "auto",
    "status": "delivered",
    "payload": "LPA:1$xxx.prod.example.com$XXXXXX",
    "delivery_data": {
      "lpa": "LPA:1$xxx.prod.example.com$XXXXXX",
      "number": "8985...",
      "verify_code": "",
      "qrcode": "data:image/png;base64,...",
      "image_url": ""
    }
  }
}

Statuses, Errors, And Risk Controls

{
  "ok": false,
  "error_code": "insufficient_stock",
  "error_message": "Insufficient stock"
}