先明确接入要完成哪几个环节

飞机号批发 API 的目标，是把人工查商品、确认余额、创建采购和获取订单结果串起来。接入前先画清自己的流程：网站收到客户请求后，哪个服务查询商品，哪个服务提交采购，最终由哪里显示交付结果。不要把“接口返回成功”直接等同于客户已收到全部资料。

西西批发网提供商品、余额和订单接口。准备接入时，可在本站登录账户后查看 API 接入说明，先完成只读查询，再按明确的测试预算验证真实下单。生产密钥只保存在你自己的服务器端。

用接入状态接口确认地址与权限

创建密钥后，按页面说明通过 Authorization 请求头传递，不要拼进公开网页网址，也不要写进浏览器前端代码。先查询 /api/v1/status，核对连接状态、商店上下文、下单权限和返回的请求额度，再继续接入。

接口域名和创建密钥时所属商店需要一致。遇到密钥无效或商店不匹配，应先检查接入配置；不能拿其他账户的密钥或修改请求参数来绕过权限边界。停用密钥后，也应同步检查自己的服务配置。

商品价格与余额都从本次查询取得

查询 /api/v1/products 后，用接口返回的 product_id 选择商品，读取可售状态、数量和报价。网页商品地址中的编号不等同于 API 商品标识，不能凭标题或某个数字自行推算。准备下单时，应使用与本次查询对应的价格参数。

余额接口为 /api/v1/balance。接入程序应按返回字段与币种处理金额，避免把人民币字段当成 USDT 使用，或把历史换算结果直接作为新订单的支付预算。自有网站的展示金额，也要与实际采购和客户扣款记录对得上。

为每个业务订单保存唯一采购标识

提交采购前生成并保存 client_order_id，再调用 /api/v1/orders。这个标识应与自己网站的业务订单固定对应，网络中断后继续使用原标识查询结果，不能为了重试不断生成新的采购标识。

若返回结果不明或请求超时，先按原 client_order_id 查单。确认不存在且符合接口重试规则时，再以相同参数处理；不要在未查清是否已经扣款的情况下新建第二笔采购。这样能减少客户只买一次、程序却重复拿货的风险。

按实际进度交付，并做好请求退避

订单仍在处理中时，按返回的状态和已交付数量展示进度。只有确认存在的资料才能提供给客户；登录链接和下载入口同样属于敏感交付信息，不应公开写入日志或允许其他客户读取。

  • 查询与下单额度按接入状态接口核对。
  • 收到 429 时按 Retry-After 等待，避免立即循环重试。
  • 结果暂不明确时优先查原订单。
  • 定期对照采购订单、余额流水和实际交付数量。
  • 涉及退款或异常时保留原始业务关联记录。

从只读检查开始接入西西批发网

有自己的站点或后台，可以先进入 xixipifa.com，登录后查看 API 接入页面和当前商品，再安排开发。先让连接、商品查询和余额读取正常，随后小范围核对真实采购与交付，最后再扩大使用。本文介绍流程，不代替账户页面中的接口参数说明。

换一个 API 密钥能增加同账号查询额度吗？
同一账号的多个密钥共用账号额度。应根据实际业务控制查询频率和保留查单记录；如果确有更高查询需求，再与本站确认适用配置。