vigxo 批量 API

开通旅行 eSIM，用程序。

一次 API 调用，就为一批同一方案的 eSIM 下单，按数量计价。每位旅客可以收到自己的安装邮件，结果从状态 URL 读取。

开通要先有一次短沟通，不能自助开通。这样报价和账单条件才是真的，不是系统猜的数字。

简单
一次带 Idempotency-Key 的、已认证的 POST。这次调用收下订单，并返回一个 id。用同一个 Idempotency-Key 再请求一次，不会把这张订单再买一遍。
异步
开通在返回 202 之后还会继续。eSIM 准备好之后，GET 这个订单，读取每张的安装信息。不用做 webhook。
可控
订单从你企业账户里的预存余额支付。每把密钥可以选配每日和每月的支出上限。
按量计价
按你的数量报价，不是单独买一张时的那个价格。

怎么运作

POST https://vigxoesim.com/api/v1/bulk/orders
Authorization: Bearer <your API key>
Idempotency-Key: <unique per attempt>
Content-Type: application/json

{
  "planSlug": "<slug from GET /api/plans>",
  "quantity": 2,
  "locale": "en",
  "travelers": [
    { "name": "Ada Lovelace", "email": "ada@example.com" },
    { "name": "Grace Hopper", "email": "grace@example.com" }
  ]
}

202 { "orderId": "…", "status": "pending" }

GET https://vigxoesim.com/api/v1/bulk/orders/<orderId>

状态响应里会列出每一张已经准备好的 eSIM：昵称、安装信息、到期时间。有旅客名单时，每人收到自己的安装邮件，你收到一封汇总。没有名单时，每封安装邮件都发到你的联系地址。

阅读批量 API 参考