手把手教你链动小铺API对接，让你的发卡网自动跑起来

根据提供的技术教程内容，摘要如下：本指南手把手教你完成链动小铺API对接，实现发卡网自动化运营，核心步骤包括：在链动小铺后台获取API密钥与接口地址；在发卡网后台配置商品信息、价格及库存同步参数；编写或利用现成插件实现订单自动处理、发货通知与库存扣减功能，通过对接，用户下单后系统自动调用API创建订单并返回卡密，无需人工干预，需注意接口安全验证、频率限制及错误日志处理，确保稳定运行，最终实现发卡网7x24小时无人值守自动跑单。

兄弟们,做自动发卡这行的，谁还没几个平台挂着呢？

我刚开始那会儿,最头疼的事儿就是手动发货，顾客拍了东西，我得眼巴巴盯着屏幕，跑去一个个复制卡密、粘贴发过去，单子少还能凑合，赶上活动或者流量高峰，那简直是噩梦，后来，我上了发卡网，算是解放了一半的双手。

可新的问题又来了：流量来源太单一。

接触“链动小铺”这个平台，其实也是个偶然，听说他们流量不错，能帮我对接公众号、小程序，甚至还有直播带货的窗口，但问题是，这玩意儿跟我的发卡网不互通啊！总不能我在链动上接一单，再跑回发卡网后台手动操作一遍吧？

那这不成“手动半自动”的智障模式了吗？必须得让他俩“私通”一下。

我花了一下午时间,啃下了链动小铺的API文档，过程嘛，有点曲折，但搞定之后，那叫一个丝滑，今天就把我的经验掰开揉碎了讲给你听，保证你看完之后，也能让发卡网和链动小铺自己“玩”到一块儿去。

第一步：搞懂他俩在“说”什么

我们先不聊代码,先聊聊“人话”。

你的发卡网,就像一个自建的仓库（API接口），里面堆满了各种商品的卡密。 链动小铺，则是一个热闹的大商场（平台），顾客在这里看东西、下单。

API对接,说白了，就是在仓库和商场之间铺一条自动化的传送带。

整个流程是这样：

1. 顾客在链动小铺上买了个“高级会员激活码”。
2. 链动小铺的服务器收到订单,它大喊一声：“嘿，发卡网仓库！来活了！给我发一个‘高级会员激活码’！”
3. 你的发卡网服务器（通过API接口）听到召唤，去库里找到这个商品，把卡密丢到传送带上。
4. 链动小铺收到卡密,自动发给顾客。

你看,全程不用你插手，你唯一要做的，就是保证你的仓库（发卡网）货是满的，以及这条传送带（API）的规则设置正确。

链动小铺的API,本质上就是一个“请求-响应”机制，它发一个HTTP请求（就相当于来店里喊一声），你的发卡网必须给出一个正确的响应（把货物递过去），如果不会“说人话”（比如格式不对、密码不对），它就会一直喊，或者直接告诉你“查无此人”。

第二步：动手前的准备工作（别急，先拿齐钥匙）

要进这个门,你得先有钥匙和地图。

1. 搞明白你是“谁家”的发卡网？ 市面上的发卡网系统很多，比如易支付系的、免签支付系的、还有开源的Zkeys、独角数卡等等，链动小铺的API对接方式，根据你的发卡网系统不同，细节会有点区别，如果是用最主流的发卡系统（比如基于easypanel或类似衍生版），那恭喜你，通用性最强，请先确认好你的发卡网系统，并确保它支持“外部API”或“链动模式/分销API”功能，这通常需要在后台插件或设置里开启。

2. 找到你的“身份证”和“密码”。 在链动小铺的商家后台（通常在“开发者中心”或“接口管理”里），你会找到两个东西：

   • AppKey（应用ID）：你的公开身份证。
   • AppSecret（应用密钥）：你的秘密通行证。这东西千万别泄露！ 泄露了别人就能用你的名义调货。

3. 拿到“收货地址”。 链动小铺也会给你一个API网关地址，格式类似 https://api.liandongxiaopu.com/v1/goods（我只是举个例子，具体看你后台文档），这就是你发卡网要“送货上门”的地址。

4. 在发卡网后台，添加一个“链动小铺”合作方。 进入你的发卡网后台，找到“接口管理”或“外部对接”栏目，新建一个应用，名字就叫“链动小铺”。 把刚才从链动小铺拿到的 AppKey 和 AppSecret 填进去。 注意：很多发卡系统要求你填的“请求地址”或“回调地址”，其实是发卡网自己的服务器地址，而不是链动小铺的，具体看你的发卡网系统说明，通常是填你自己的网站URL，https://www.ni-de-faka.com/api/callback，意思是：“链动小铺，你把订单数据发到我这个地址来。”

第三步：核心动作——上架商品并“配对”

这是最关键的一步,也是很多人会搞混的地方。

不是在你的发卡网上，手动创建一份商品，再在链动小铺手动创建一份同样的商品，那样就没意义了，你要做的是，在链动小铺上创建一个“虚拟商品”，并告诉它，这个商品的实际库存和内容，由你的发卡网API来“托管”。

具体操作（以通用流程为例）：

1. 在发卡网创建商品： 正常创建你的商品，100元话费慢充”，唯一要特别注意的，是商品ID，你的发卡网后台，给每个商品都分配了一个唯一的ID，goods_12345。记下这个ID，它是关键钥匙。

2. 在链动小铺创建“API商品”：

   • 商品类型：选择 API自动发货 或 外部商品。
   • 商品名称：可以和发卡网上一样，也可以不一样，随你。
   • 外部商品ID（或商家商品ID）：这里！ 把刚才在发卡网记下的商品ID（goods_12345）填进去，链动小铺就是靠这个ID，去你的发卡网上掏货。
   • 售卖价格：这是你最终卖给顾客的价格。
   • 结算价格 / 供货价格：这是你（或你的下游）实际拿到手的价格，通常会扣除佣金，这部分要跟你的发卡网售价逻辑对上，避免亏本。

重点来了： 链动小铺怎么知道，顾客买的是你的“100元话费慢充”呢？它就是用那个外部商品ID去API里找到对应的，只要你在链动小铺后端，把“外部商品ID”填对，逻辑就连上了。

第四步：关键的“代码桥接”——搞定API签名和请求

如果你用的是现成的发卡网系统（比如独角数卡、Zkeys），这一步其实不需要你写代码，只需要在后台配置好请求参数即可，但原理你得懂，不然出了问题抓瞎。

当你配置好之后,你的发卡网系统（或者你手动写的脚本）就会向链动小铺的API网关发送一个POST请求，这个请求不是光秃秃发一个商品ID就行，它要带上“身份证”和“签名”。

签名（Sign） 是防篡改的，办法是：把所有参数（AppKey、商品ID、订单号、时间戳等）按特定规则排序，连接成一个字符串，再在末尾加上你的 AppSecret，然后算出MD5值，把这个MD5值作为sign参数发过去，链动小铺收到后，会用同样的方式重新算一遍，如果结果一致，证明这个请求是你本人发出的，没有被黑客修改过。

一个典型的请求示例（伪代码）：

POST https://api.liandongxiaopu.com/v1/order/create
Content-Type: application/x-www-form-urlencoded
app_key=你的AppKey
&out_trade_no=订单号（由你的发卡网生成，唯一）
&goods_id=外部商品ID（比如goods_12345）
&buyer_account=买家账号（可选）
&timestamp=当前时间戳（1688888888）
&sign=MD5(排序后的所有参数 + AppSecret)

响应示例（成功）：

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "链动小铺的订单号",
    "goods_name": "100元话费慢充",
    "card_info": "本次发货的内容，比如卡密或链接 (一般会是加密的)",
    "status": 1 // 1表示成功，其他表示失败
  }
}

第五步：测试！测试！测试！

千万别一上来就正式开卖,一定要先用1分钱商品或者测试专用商品跑一遍流程。

1. 在发卡网创建一个测试商品,售价0.01元，卡密为“test123”。
2. 在链动小铺创建一个测试商品,关联上这个发卡网的测试商品ID。
3. 用你自己的小号下单购买,看看能不能成功收到卡密？如果收到了，并且正确，恭喜你，对接成功！

如果收不到，请检查这几样：

• AppKey和AppSecret是否正确？
• 签名算法是否一致？ 这是90%错误的根源，检查参数排序规则、有没有漏掉某个参数、大小写问题。
• 商品ID是否匹配？
• 发卡网的IP白名单是否设置了？ 有些发卡网只允许特定IP访问API，你要把链动小铺的服务器IP加进去。
• 日志！日志！日志！ 进入发卡网和链动小铺的后台，查看API请求日志，看看请求是否到达？返回了什么错误代码？这是最好的调试工具。

写在最后的一点心里话

说穿了,API对接就是一个“约定”，你俩约好用哪种暗号、走哪条路、怎么证明是自己，一旦约定好了，剩下的就是系统之间自动的“你来我往”。

把这套东西跑通之后,你会发现世界清静多了，我现在的模式是：在自己的发卡网后台统管所有商品库存和卡密，然后一键把商品“铺”到链动小铺、自己的公众号H5小店、甚至一些其他合作平台，哪个平台有单，都直接从我的“仓库”里自动出库，我再也不用像个机器人一样到处粘贴复制了。

自动化不是目标,解放你的时间才是，把这套基础API对接搞定了，你就有更多精力去思考怎么搞流量、怎么优化产品、怎么和顾客聊聊天，这才是真正能帮你赚钱的事。

希望这篇“口水话”教程对你有用，别怕，上手搞一搞，真不难，如果卡住了，记得去找官方开发者的文档，那才是最权威的，咱们下期见！

本文链接：https://www.ncwmj.com/news/10478.html