開發者中心 - Mili Express

REST API 文件

探索、測試並整合我們的 RESTful 端點。完整的 Swagger UI，支援互動式請求建立和身分驗證。

REST API

GraphQL API 文件

透過 GraphQL API 精確查詢所需資料。互動式 Playground，支援 Schema 瀏覽和操作測試。

GraphQL

MCP 專欄

AI 代理與 MCP 客戶端：設定、安全 profile、審批以及 User + Developer 伺服器的即時工具。

MCP

對接專題

四條各自閉環的路徑。打開哪一條就只做哪一條：鑑權、詢價、下單、打標或支付、追蹤，以及測試清單。

發運對接

自有車隊取件與配送

建立取件或配送訂單、列印本地面單、追蹤並接收事件——自有車隊，從頭做到尾。詢價為可選步驟。

取件或配送 → 本地面單 → 追蹤 → 事件

車隊

承運商打單

取得運送方式、詢價、購買承運商面單、下載 PDF，並追蹤該票。

運送方式 → 詢價 → 打單 → PDF → 追蹤

打單

Uniorder：所有貨件統一一個介面

無論由商戶自行配送或購買承運商面單，皆透過同一組介面完成詢價、下單、列印面單、追蹤與取消。

詢價 → rate_id → 下單 → 面單 → 追蹤 → 取消

統一下單

一次詢價與下單

一次詢價同時列出自有配送與所有承運商面單服務，再以所選報價的 rate_id 下單。

詢價 → rate_id → 下單 → 購買面單 → 取消

詢價下單

運送服務

使用物流公司自有運送服務：列出服務、估價、下單、付款、追蹤。

服務列表 → 估價 → 下單 → 付款 → 追蹤

服務

倉儲與出庫

先把貨物入庫存放並付款，再在本路徑上把在庫件出庫寄出。

入庫 → 付款 → 選貨 → 出庫 → 追蹤

倉儲

MCP 專欄

MCP 93 tools

面向 AI 代理與 MCP 客戶端的專項指南：User / Developer 伺服器、最小權限 profile、dry-run、人工審批與即時工具目錄。

Profile 與 scopes 人工審批寫入 dry-run Developer MCP

網路鉤子 — Webhook 整合指南

即時接收 Superroute 事件 — 訂單、狀態變更、追蹤更新。附簽章驗證、自動重試與內建除錯工具。

WEBHOOKS

OTEP — 開放追蹤事件協議

一個事件，無限旅程。 — 自配送、第三方配送與承運商貨件，依每個追蹤號碼合併為單一且有序的事件時間軸。

OTEP

整合更新指南

API 與 Webhook 的全部新能力——冪等取消、對帳拉取、v2 簽章、新事件——附可直接複製的範例，全部向前相容。

NEW

Postman Collection

從 API 文件即時產生的最新集合——匯入 Postman 即可開始呼叫 API。

JSON

訂單狀態字典與流轉圖

完整的訂單狀態字典與流轉圖，由部署程式碼即時產生。

MARKDOWN

運單事件代碼

取件側與配送側運單事件代碼、OTEP 對應、常見流轉，以及用公開 API 自建追蹤頁的說明。

TRACKING

快速入門

取得 API Token

登入後前往設定 → API 金鑰，產生您的個人存取權杖。

選擇 API 類型

標準增刪改查操作使用 REST，彈性資料查詢使用 GraphQL，將 AI 助理直接接入物流資料使用 MCP。

開始開發

開啟互動式文件，直接在瀏覽器中測試介面，再將程式碼範例複製到您的應用程式中。

身份驗證

三種API使用相同的Bearer令牌（透過登入端點取得）。部分端點無需認證即可使用——包括登入、公開追蹤和司機自助註冊。

透過登入介面取得 Token：

                # POST /api/v1/user/login

                { "email": "you@example.com", "password": "••••••••" }

請求標頭

Authorization: Bearer YOUR_ACCESS_TOKEN

REST 大多數端點需要認證。登入、公開追蹤和司機自助註冊為公開端點（無需令牌）。

GQL 已認證的操作需要 Token；登入、追蹤等公開操作無需 Token。

MCP 可選。公開工具無需 Token；攜帶有效 Token 後可存取個人資料。

接口基礎網址

REST API https://api.miliexpress.com/api
GraphQL https://api.miliexpress.com/api/graphql
MCP https://api.miliexpress.com/api/mcp

應該選哪種 API？

REST API

標準增刪改查、Webhook、訂單/路線管理

GraphQL

彈性取數、自訂報表、巢狀查詢

MCP

AI 助理整合（Claude、Cursor、Copilot 等）

AI 整合

賦予您的 AI 助手物流超能力。透過 MCP 實現零程式碼設定，從您的 AI 代理直接呼叫我們的 API，或下載技能檔案取得完整的語義指引。

可用功能

公開追蹤

透過追蹤號碼查詢任何包裹的配送狀態、事件時間軸和簽收證明（簽名/照片）。

公開

操作事件

取得訂單的完整稽核記錄——誰變更了什麼狀態、何時、何地，包含 GPS 座標和附件照片。

需要認證

標籤服務

從承運商取得運費報價、建立運輸標籤、下載標籤 PDF、取消運輸和提交日終清單。

需要認證

本地配送

建立配送/取件訂單、建構最佳化的多司機路線，並管理完整的最後一哩配送流程。

需要認證

END USER 使用者 MCP 伺服器

適用於您客戶使用的 AI 助手。貼上設定後，您的 AI 即可即時追蹤包裹——無需撰寫程式碼。

ENDPOINT

https://api.miliexpress.com/api/mcp

可用工具 (93 個即時工具)

track_package Track a package by its tracking number. Returns delivery status, trackin... 公開

otep_tracking Get the unified OTEP (Open Tracking Event Protocol) timeline for a track... 公開

get_capabilities List MCP tools available to the current connection, with risk level, req... 公開

get_orders List orders with filtering and pagination. Returns order details includi... 認證

get_order_detail Get full details of a specific order by ID, including address, status, p... 認證

find_order Fuzzy-find orders across tracking number, external tracking, ref, recipi... 認證

get_operation_events Get the full audit trail for orders — every status change, who performed... 認證

create_order Create a delivery/pickup order. D=delivery (warehouse→customer), P=picku... 認證

cancel_order Cancel an existing order by order ID. Only works for orders not yet deli... confirm

bulk_create_orders Create up to 100 delivery orders in one call. Returns a per-order succes... confirm

reroute_to_address Change the delivery address of an order that has not been picked up yet:... confirm

update_delivery_instruction Update only the delivery_instruction field on an existing order (PATCH).... 認證

update_order_note Update only the internal note field on an existing order (PATCH). 認證

update_time_window_by_refs Bulk-update delivery time windows (and optional schedule_date) for order... 認證

hold_order Put an order on HOLD so it is not dispatched until release_order. HIGH-R... confirm

release_order Release an order from HOLD back to NEW_ORDER. HIGH-RISK: requires confir... confirm

propose_write Queue a write/high-risk tool for human approval instead of executing it.... 認證

list_pending_approvals List pending MCP write approvals for this business (or mine_only). 認證

approve_pending_write Approve and execute a pending write proposal. HIGH-RISK: requires confir... confirm

reject_pending_write Reject a pending write proposal without executing it. 認證

get_routes List delivery routes with their status, assigned driver, and order count... 認證

get_route_detail Get one route with its stop/order list. Prefer this over get_routes when... 認證

get_drivers List drivers for the authenticated business (ids, names, capacity defaul... 認證

get_driver_routes_today Orders assigned to a driver on a given date (defaults to today). Useful... 認證

get_build_route_options List routing engines, balance modes, capacity types, and defaults before... 認證

build_route Build/optimize a delivery route (POST /api/v3/client/build-route). HIGH-... confirm

order_snapshot One-call order context for support: order detail + operation events + pu... 認證

list_exceptions List failed/returned/exception-like orders for a schedule date (default... 認證

get_shipping_methods List available shipping carriers/methods. Returns IDs and names — use th... 認證

get_shipping_rate Get a shipping cost quote. Dry-run — no label created. Returns rate opti... 認證

create_shipping_label Book a shipment with a carrier and generate a shipping label with tracki... 認證

quote_and_ship One-shot: rate across all enabled carriers, pick the best one by strateg... 認證

compare_all_carriers Get rate quotes from every enabled carrier for the same shipment, in one... 認證

search_address Search and resolve addresses by postal code or free-text query. Returns... 認證

daily_digest One-call summary of today's logistics activity: total orders, by status,... 認證

get_orders_summary Aggregate order metrics over a time window: counts by status, top carrie... 認證

get_account_credits Get the authenticated customer's wallet balance, currency, and recent to... 認證

get_warehouses List WMS warehouses available to the authenticated business. 認證

get_inventory Query WMS inventory (POST /api/v1/wms/inventory). Pass filters supported... 認證

list_datasets List custom datasets available to the business. 認證

get_dataset Get one dataset by id (metadata/columns). 認證

list_dataset_groups List groups inside a dataset. 認證

search_dataset_records Search records across groups in a dataset (POST .../search). 認證

list_alliances List alliances the authenticated business belongs to. 認證

get_alliance Get one alliance by id. 認證

list_alliance_members List members of an alliance. 認證

list_accessible_clients List clients accessible via alliance partnerships. 認證

quote_delivery Get the local delivery price for a shipment before creating the order (P... 認證

print_local_label Get the printable label of a local delivery order as a base64 PDF, with... 認證

bulk_create_orders_async Queue a large batch of delivery orders for creation (POST /api/v1/client... confirm

get_async_batch_result Read the status and per-order results of a batch queued with bulk_create... 認證

get_shipping_detail Get the carrier shipping detail of a label order: tracking numbers, pric... confirm

download_shipping_label Download the label PDF of an order as base64 (POST /api/v1/shipping/getS... confirm

cancel_shipping_label Cancel (void) a carrier label with the carrier (POST /api/v1/labelservic... confirm

submit_shipping_information Submit the shipping information of one or more label orders to their car... confirm

end_of_day Close the day with the carriers: submit the shipping information of ever... confirm

uniorder_rate Quote one shipment across self delivery and, with quote_labels=true, eve... 認證

uniorder_create Create an order at a rate_id from uniorder_rate (POST /api/v1/uniorder).... 認證

uniorder_get Read one uniorder order in the uniorder shape (GET /api/v1/uniorder/{ord... 認證

uniorder_label Get the label PDF of a uniorder order, base64 (GET /api/v1/uniorder/{ord... 認證

uniorder_tracking Get the tracking timeline of a uniorder order (GET /api/v1/uniorder/{ord... 認證

uniorder_cancel Cancel a uniorder order, self delivery or label (POST /api/v1/uniorder/{... confirm

uniorder_purchase_label Buy the carrier label of a uniorder label order that was kept without on... confirm

uniorder_rate_batch Quote up to 20 shipments in one call (POST /api/v1/uniorder/rate/batch).... 認證

uniorder_create_batch Create up to 20 orders in one call, each at its own rate_id (POST /api/v... confirm

uniorder_rate_batch_async Queue up to 500 shipments to quote (POST /api/v1/uniorder/rate/batch-asy... 認證

uniorder_create_batch_async Queue up to 500 orders to create, each at its own rate_id (POST /api/v1/... confirm

uniorder_job Read a queued uniorder batch and, once done, its results (GET /api/v1/un... 認證

list_shipping_services List the shipping services the customer may order (GET /api/v1/customer/... 認證

get_shipping_service_config Get one shipping service's order form: warehouses, surcharges, packaging... 認證

estimate_shipping_order Estimate the price of a shipping order on a service (POST /api/v1/custom... 認證

create_shipping_order Create a shipping order on a service (POST /api/v1/customer/shipping-ord... 認證

pay_shipping_order Pay the full remaining balance of a shipping order from the customer wal... confirm

get_shipping_order Get one shipping order of the customer (GET /api/v1/customer/shipping-or... 認證

list_shipping_orders List the customer's shipping orders on one service, paginated (GET /api/... 認證

cancel_shipping_order Cancel a pending or confirmed shipping order of the customer (POST /api/... confirm

get_storage_order_config Get what a storage order form needs: warehouses, packaging, supplies, pi... 認證

quote_storage_order Calculate the price of a storage order before creating it (POST /api/v1/... 認證

create_storage_order Create a storage order (POST /api/v1/customer/storage-orders). Storage o... 認證

pay_storage_order Pay a storage order from the customer wallet (POST /api/v1/customer/stor... confirm

get_storage_order Get one storage order of the customer, with can_edit, can_cancel and eac... 認證

list_storage_orders List the customer's storage orders, paginated (GET /api/v1/customer/stor... 認證

cancel_storage_order Cancel a storage order of the customer while its status allows it (POST... confirm

list_stored_packages List the customer's stored packages that can be shipped out: received, n... 認證

list_shipout_services List the shipping services that ship out from a warehouse (GET /api/v1/c... 認證

estimate_shipout Estimate the price of a ship-out (POST /api/v1/customer/shipout-orders/s... 認證

create_shipout Create a ship-out of stored packages from one warehouse (POST /api/v1/cu... 認證

pay_shipout Pay a priced ship-out from the customer wallet (POST /api/v1/customer/sh... confirm

get_shipout Get one ship-out of the customer with paid amount, remaining balance, ca... 認證

list_shipouts List the customer's ship-outs, paginated (GET /api/v1/customer/shipout-o... 認證

cancel_shipout Cancel a pending or confirmed ship-out and release its stored packages (... confirm

otep_client_tracking Get the OTEP timeline and details (addresses, dates, proof of delivery,... 認證

otep_client_locker_storage Get the OTEP timeline (storage profile) and details of one of your locke... 認證

// .mcp.json — 窄權限營運代理設定
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.miliexpress.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

DEVELOPER 開發者 MCP 伺服器

適用於協助您建構 Superroute 整合的 AI 編碼助手（Claude Code、Cursor 等）。您的 AI 可以直接呼叫 API、測試端點並產生整合程式碼。

ENDPOINT

https://api.miliexpress.com/api/mcp/developer

可用工具 (25 個即時工具)

track_package 透過追蹤號碼追蹤包裹公開

get_operation_events 取得訂單稽核記錄認證

get_shipping_methods 列出可用承運商認證

get_shipping_rate 取得運費報價認證

create_shipping_label 建立運輸標籤認證

get_shipping_label 取得面單詳情及下載資訊認證

create_order 建立配送/取件訂單認證

build_route 建立優化配送路線認證

get_build_route_options Get available options for building routes: routing engines with their balance modes, capacity ty... 認證

get_api_endpoints Search the complete Superroute REST API catalog (the same OpenAPI spec that powers /api/document... 公開

get_graphql_operations Search the Superroute GraphQL catalog — every query and mutation, grouped by category, each with... 公開

run_graphql_query Execute a query or mutation against the Superroute GraphQL endpoint (POST /api/graphql) and retu... 認證

get_otep_tracking Get a package's tracking history as an OTEP (Open Tracking Event Protocol) document — the normal... 公開

validate_otep_payload Run an OTEP document or event through the live conformance validator (POST /api/v1/otep/validate... 公開

check_skill_update Check if a newer version of the Superroute AI integration skill file is available. Returns curre... 公開

get_integration_guide 取得整合指南公開

get_otep_guide Get the OTEP (Open Tracking Event Protocol) development guide — the What/When/Where/Why event mo... 公開

get_webhook_guide Webhook 整合指南公開

verify_webhook_signature Verify whether an incoming webhook signature is valid. Pass the raw payload (string or JSON obje... 公開

test_webhook_delivery Fire a real, properly-signed test webhook from Superroute servers to a URL the developer provide... 認證

get_webhook_settings Read the caller's own webhook configuration — every per-event callback URL, the behaviour flags,... 認證

update_webhook_settings Self-serve update of the caller's webhook configuration (PUT /api/v1/webhook-settings). Partial:... 認證

get_order_audit_timeline Chronological audit timeline of ONE order across every source: web actions, driver app scans, wa... 認證

get_webhook_delivery_logs List recorded webhook delivery attempts for the caller — event type, target URL, HTTP status, at... 認證

replay_webhook_delivery Re-send a webhook that was already logged, by delivery-log id (get the id from get_webhook_deliv... 認證

// .mcp.json — 優先連線級 Bearer
{
  "mcpServers": {
    "superroute-dev": {
      "type": "url",
      "url": "https://api.miliexpress.com/api/mcp/developer",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

2026-12-31 之後請勿在工具參數中傳 api_token，請使用 MCP 連線的 Authorization。

User MCP 用於代理管理 Superroute；Developer MCP 用於建立整合。完整安全模型、profile 與即時工具列表見 MCP 專欄。開啟 MCP 專欄 →

AI 工具發現端點

為 AI 代理、LLM 工具呼叫系統和 MCP 客戶端提供的結構化能力描述。所有端點均公開，無需認證。

PRIMARY AI 工具清單

完整清單，包含工具定義、Schema、認證資訊和工作流。

GET https://api.miliexpress.com/api/.well-known/ai-tools.json

也可使用： /llms.txt

FORMAT 多格式匯出

取得適配您 AI 平台原生格式的工具定義。

# OpenAI function calling
GET https://api.miliexpress.com/api/ai/tools?format=openai

# Anthropic Claude tool_use
GET https://api.miliexpress.com/api/ai/tools?format=anthropic

# MCP tools/list
GET https://api.miliexpress.com/api/ai/tools?format=mcp

# LangChain StructuredTool
GET https://api.miliexpress.com/api/ai/tools?format=langchain

REST OpenAPI + AI 擴充

OpenAPI 規範，增加了 x-ai-* 擴充（工具名稱、使用情境、分類）。

GET https://api.miliexpress.com/api/ai/tools/openapi

GQL GraphQL + AI 提示

GraphQL 文件，每個操作增加了 aiHints（使用情境、關聯工作流）。

GET https://api.miliexpress.com/api/ai/tools/graphql

快速整合

Python（OpenAI SDK ）

import requests, json
tools = requests.get(
  "https://api.miliexpress.com/api/ai/tools?format=openai"
).json()["tools"]

# Pass to OpenAI
response = client.chat.completions.create(
  model="gpt-4",
  messages=messages,
  tools=tools
)

Python（克勞德 SDK ）

import requests, anthropic
tools = requests.get(
  "https://api.miliexpress.com/api/ai/tools?format=anthropic"
).json()["tools"]

# Pass to Claude
response = client.messages.create(
  model="claude-sonnet-4-20250514",
  messages=messages,
  tools=tools
)

Node.js（取得）

const res = await fetch(
  "https://api.miliexpress.com/api/ai/tools?format=openai"
);
const { tools } = await res.json();

// Use with any LLM SDK
console.log(`Loaded ${tools.length} tools`);

能力概覽： 取得輕量級概覽（僅類別和工具名稱），請使用 GET https://api.miliexpress.com/api/ai/capabilities

AI 工具 Playground

直接在瀏覽器中測試 Superroute AI 工具。選擇一個工具，填寫參數，查看即時 API 回應。

選擇工具

track_package

請求主體 (JSON)

回應

點擊「執行」來執行工具...

使用 REST 或 GraphQL 建構

適用於建構自訂 AI 代理、聊天機器人或程式化整合的開發者。從您的程式碼中直接呼叫我們的 API，全面存取所有物流功能。

REST REST API 端點

# 追蹤包裹（公開）
GET https://api.miliexpress.com/api/v1/tracking/{number}

# 操作事件
POST https://api.miliexpress.com/api/v1/tracking/operationevents

# 取得運費報價
POST https://api.miliexpress.com/api/v1/labelservice/rate

# 建立運輸標籤
POST https://api.miliexpress.com/api/v1/labelservice/submitOrder

# 建立配送訂單
POST https://api.miliexpress.com/api/v1/client/orderCreate

# 建構最佳化路線
POST https://api.miliexpress.com/api/v3/client/build-route

# 設定 Webhook
PUT https://api.miliexpress.com/api/v1/webhook-settings

# 開放追蹤時間軸（OTEP）
GET https://api.miliexpress.com/api/v1/otep/trackings/{number}

完整文件

GQL GraphQL 操作

# 單一端點
POST https://api.miliexpress.com/api/graphql

# 可用操作
trackingPublic       ← 追蹤包裹（公開）
trackingOperationevents ← 操作事件
labelserviceRate      ← 取得運費報價
labelserviceSubmitOrder ← 建立運輸標籤
clientOrderCreate     ← 建立配送訂單
clientBuildRoute      ← 建構最佳化路線
webhookSettingsUpdate ← 設定 Webhook
otepTracking          ← 開放追蹤時間軸（OTEP）

完整文件

我們建議大多數 AI 整合使用 REST API——它更容易除錯，每個端點都是獨立的。當您需要彈性查詢或想在單次請求中取得巢狀資料時，請使用 GraphQL。

Superroute AI 整合技能

一個全面的技能檔案，包含深度物流領域知識——每個 API 的功能、使用時機、參數在實際業務場景中的含義、如何解讀結果，以及各功能如何組合使用。

下載技能檔案 (.md)

如何使用技能檔案

Claude Code

1 下載上述檔案
2 將其放置在專案的 .claude/skills/ 目錄中
3 在 Claude Code 中輸入 /integrate 啟動互動式精靈

mkdir -p .claude/skills
cp superroute-ai-integration.md .claude/skills/

Cursor

1 下載上述檔案
2 將其放置在專案的 .cursor/rules/ 目錄中
3 Cursor 將在您詢問 Superroute 整合時自動將其用作上下文

mkdir -p .cursor/rules
cp superroute-ai-integration.md .cursor/rules/

其他 AI 工具

1 下載上述檔案
2 將內容貼到您 AI 工具的系統提示或知識庫中
3 AI 將使用語義描述來指導整合

# 或貼到系統提示中
cat superroute-ai-integration.md

保持技能檔案為最新版本

快速一鍵升級

直接從伺服器下載最新的技能檔案，覆蓋本地副本。

# Claude Code
curl -sS https://api.miliexpress.com/api/ai-skill -o .claude/skills/superroute-ai-integration.md

# Cursor
curl -sS https://api.miliexpress.com/api/ai-skill -o .cursor/rules/superroute-ai-integration.md

API 版本檢查 API

下載前先檢查伺服器上的最新版本。將雜湊值與本地檔案對比，判斷是否需要更新。

GET https://api.miliexpress.com/api/ai-skill/version

回應:
{ "version": "1.0.0", "hash": "abc123...", "download_url": "..." }

MCP 透過 MCP 自動更新

如果您已連接開發者 MCP 伺服器，AI 助手可以使用 check_skill_update 工具檢查更新。傳入本地檔案的 MD5 雜湊值即可獲取 update_available 布林值。

// 透過開發者 MCP 伺服器呼叫
{
  "method": "tools/call",
  "params": {
    "name": "check_skill_update",
    "arguments": { "current_hash": "your_local_file_md5_hash" }
  }
}

CRON 自動更新腳本 (Cron / CI)

將此腳本加入 CI 流程或 cron 任務中，自動保持技能檔案始終為最新版本。

#!/bin/bash
# auto-update-skill.sh
SKILL_FILE=".claude/skills/superroute-ai-integration.md"
BASE_URL="https://api.miliexpress.com"

mkdir -p "$(dirname "$SKILL_FILE")"
LOCAL_HASH=$(md5sum "$SKILL_FILE" 2>/dev/null | cut -d' ' -f1)
SERVER_HASH=$(curl -s "$BASE_URL/api/ai-skill/version" | python3 -c "import sys,json; print(json.load(sys.stdin)['hash'])")

if [ "$LOCAL_HASH" != "$SERVER_HASH" ]; then
  curl -sS "$BASE_URL/api/ai-skill" -o "$SKILL_FILE"
  echo "Updated!"
fi

技能檔案不僅僅是 API 文件——它教會您的 AI 助手每個參數的業務含義、如何解讀回應，以及如何組合功能以處理複雜的物流工作流。

程式碼範例

REST REST API — 追蹤包裹

追蹤包裹（無需令牌）

curl https://api.miliexpress.com/api/v1/tracking/SR123456

追蹤包裹（無需令牌）

<?php
$res = (new \GuzzleHttp\Client())->get('https://api.miliexpress.com/api/v1/tracking/SR123456');
print_r(json_decode($res->getBody(), true));

追蹤包裹（無需令牌）

import requests
res = requests.get('https://api.miliexpress.com/api/v1/tracking/SR123456')
print(res.json())

追蹤包裹（無需令牌）

resp, _ := http.Get("https://api.miliexpress.com/api/v1/tracking/SR123456")
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)

追蹤包裹（無需令牌）

const res = await fetch('https://api.miliexpress.com/api/v1/tracking/SR123456');
const data = await res.json();

追蹤包裹（無需令牌）

HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miliexpress.com/api/v1/tracking/SR123456"))
    .build();
HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

追蹤包裹（無需令牌）

require 'net/http'
puts Net::HTTP.get(URI('https://api.miliexpress.com/api/v1/tracking/SR123456'))

GQL GraphQL — 查詢訂單

查詢訂單

curl -X POST https://api.miliexpress.com/api/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"query { trackingPublic(trackingNumber: \"SR123456\") { trackingNumber status events { timestamp description } } }"}'

查詢訂單

$query = 'query { trackingPublic(trackingNumber: "SR123456") { trackingNumber status } }';
$res = (new \GuzzleHttp\Client())->post('https://api.miliexpress.com/api/graphql', [
    'json' => ['query' => $query, 'variables' => []],
]);
print_r(json_decode($res->getBody(), true));

查詢訂單

import requests
query = 'query { trackingPublic(trackingNumber: "SR123456") { trackingNumber status } }'
res = requests.post('https://api.miliexpress.com/api/graphql', json={'query': query, 'variables': {}})
print(res.json())

查詢訂單

payload, _ := json.Marshal(map[string]interface{}{
    "query":     `query { trackingPublic(trackingNumber: "SR123456") { trackingNumber status } }`,
    "variables": map[string]interface{}{},
})
req, _ := http.NewRequest("POST", "https://api.miliexpress.com/api/graphql", bytes.NewBuffer(payload))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

查詢訂單

const res = await fetch('https://api.miliexpress.com/api/graphql', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ query: `query { trackingPublic(trackingNumber: "SR123456") { trackingNumber status } }` }),
});
const data = await res.json();

查詢訂單

String body = "{\"query\":\"query { trackingPublic(trackingNumber: \\\"SR123456\\\") { trackingNumber status } }\"}";
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miliexpress.com/api/graphql"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body)).build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());

查詢訂單

require 'net/http'; require 'json'
uri = URI('https://api.miliexpress.com/api/graphql')
req = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json')
req.body = JSON.dump({ query: 'query { trackingPublic(trackingNumber: "SR123456") { trackingNumber status } }' })
puts Net::HTTP.start(uri.hostname, uri.port) { |h| h.request(req) }.body

MCP MCP — 追蹤包裹

追蹤包裹（無需 Token）

curl -X POST https://api.miliexpress.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"track_package","arguments":{"tracking_number":"SR123456"}}}'

追蹤包裹（無需 Token）

$payload = [
    'jsonrpc' => '2.0', 'id' => 1, 'method' => 'tools/call',
    'params'  => ['name' => 'track_package', 'arguments' => ['tracking_number' => 'SR123456']],
];
$res = (new \GuzzleHttp\Client())->post('https://api.miliexpress.com/api/mcp', ['json' => $payload]);
print_r(json_decode($res->getBody(), true));

追蹤包裹（無需 Token）

import requests
payload = {
    'jsonrpc': '2.0', 'id': 1, 'method': 'tools/call',
    'params': {'name': 'track_package', 'arguments': {'tracking_number': 'SR123456'}},
}
res = requests.post('https://api.miliexpress.com/api/mcp', json=payload)
print(res.json())

追蹤包裹（無需 Token）

payload, _ := json.Marshal(map[string]interface{}{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": map[string]interface{}{
        "name": "track_package",
        "arguments": map[string]interface{}{"tracking_number": "SR123456"},
    },
})
req, _ := http.NewRequest("POST", "https://api.miliexpress.com/api/mcp", bytes.NewBuffer(payload))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)

追蹤包裹（無需 Token）

const res = await fetch('https://api.miliexpress.com/api/mcp', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        jsonrpc: '2.0', id: 1, method: 'tools/call',
        params: { name: 'track_package', arguments: { tracking_number: 'SR123456' } },
    }),
});
const data = await res.json();

追蹤包裹（無需 Token）

String body = "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"track_package\",\"arguments\":{\"tracking_number\":\"SR123456\"}}}";
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miliexpress.com/api/mcp"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body)).build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());

追蹤包裹（無需 Token）

require 'net/http'; require 'json'
uri = URI('https://api.miliexpress.com/api/mcp')
req = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json')
req.body = JSON.dump({ jsonrpc: '2.0', id: 1, method: 'tools/call',
    params: { name: 'track_package', arguments: { tracking_number: 'SR123456' } } })
puts Net::HTTP.start(uri.hostname, uri.port) { |h| h.request(req) }.body