阿奇索自动发货服务

加载中…

管理后台

请输入管理令牌后继续

令牌在服务配置 security.adminToken 中设置, 或用 ./agiso -init-token 生成一个。

第一步:把你的业务系统接进来。 应用是上游供货方:它把商品推给本平台缓存,阿奇索来问时本平台返回缓存; 真实发货时本平台才调应用的接口取卡密或充值结果。
应用必须填「发货接口地址」,否则阿奇索下单会失败(不会退回用本平台库存)。 配好后去「② 商品」页点「从应用拉取」。

第二步:拉商品。点「从应用拉取商品」,系统会去问应用要商品存到本地, 阿奇索查商品时返回的就是这份缓存。重复拉取是更新,不会产生重复商品。 「手动新增」用于调整价格、上下架、配直充模板。

第三步(仅「本地卡密直发」的商品需要):选中商品后点「导入卡密」。 从应用拉取的商品不用导入卡密——下单时系统会实时调你的应用取货, 库存多少也由应用说了算,本平台只负责转发。 直充商品不需要卡密,这步可以跳过。

多数情况这里只有一条——就是你自己,配好后基本不用再动。 「平台ID」和「接口调用私钥」是你在阿奇索后台的身份凭证,点每行的「接入资料」可直接查看要提交的三项内容; 「上线自检」会在提交前按阿奇索的验收规则跑一遍检查。

服务地址

把下面的地址填到阿奇索开放平台的「接入地址」里:



      

阿奇索调用本服务(被调用方)

除 getAppId 外,全部需要 sign 签名(ASCII 升序 + 空值参与 + 32 位大写 MD5)。

接口路径说明
获取应用IDPOST /agisoAcprSupplierApi/app/getAppId匿名,无需签名
商品列表POST /agisoAcprSupplierApi/product/getList需签名
商品模版POST /agisoAcprSupplierApi/product/getTemplate需签名
卡密下单POST /agisoAcprSupplierApi/order/createPurchase需签名
直充下单POST /agisoAcprSupplierApi/order/createRecharge需签名
订单查询POST /agisoAcprSupplierApi/order/get需签名
撤销订单POST /agisoAcprSupplierApi/order/cancelOrder需签名
订阅调价POST /agisoAcprSupplierApi/product/subscribePriceNotify需签名
取消订阅POST /agisoAcprSupplierApi/product/cancelSubscribePriceNotify需签名
调价通知POST /agisoAcprSupplierApi/product/notifyPriceChange需签名(双 AppSecret)

管理接口(X-Admin-Token 鉴权)

用途方法与路径
健康检查GET /healthz(无需令牌)
服务信息GET /admin/api/info
接入方列表/新增/更新/删除GET POST PUT /admin/api/merchants、DELETE /admin/api/merchants/:userId
商品列表/新增/更新/删除GET POST PUT /admin/api/products、DELETE /admin/api/products
卡密导入POST /admin/api/cards/import(JSON 或纯文本)
卡密列表/统计GET /admin/api/cards、GET /admin/api/cards/stats
订单列表/详情GET /admin/api/orders、GET /admin/api/orders/:orderNo
手动重投回调POST /admin/api/orders/:orderNo/retry-callback

开放平台接口(接入方自助,appKey 签名)

接入方用自己的 appKey 签名,只能操作自己名下的数据。

用途方法与路径
商品列表 / 新增GET POST /open/api/products
导入卡密POST /open/api/cards/import
订单列表 / 详情GET /open/api/orders、GET /open/api/orders/:orderNo
回填直充结果POST /open/api/orders/:orderNo/complete

错误码

code含义
200请求成功(仅代表通信成功)
401签名错误
403IP 不在白名单
408时间戳过期
1001 / 1002会员ID无效 / 已被禁用
1100 / 1101商品不存在 / 未开放
1220超出订单金额限制
1230库存不足
9999其他错误

完整文档见项目 docs/ 目录。