如何通过API将供应商服务与SMM面板卡片关联
为什么要把供应商目录与面板展示区分开
供应商API通常返回的是技术性目录:外部ID、名称、价格、限额、状态和下单参数。而在SMM面板中,同一个条目应当归入客户能理解的结构:平台、推广类型、地区、链接格式、受众质量或启动速度。
如果未经处理就直接输出外部目录,展示区就会出现技术性名称、重复项和不可用条目。映射将采购逻辑与客户卡片分开。一个供应商服务不一定要对应面板中的一个独立服务。
需要通过API获取哪些数据
将供应商的原始数据与展示区设置分开保存。外部ID不能用面板的内部标识符替代:它用于创建订单、获取状态、取消和排查错误。此外,建议保存最后同步时间和完整的API响应或其快照。
- 供应商标识和服务外部ID。
- 名称、描述和外部类别。
- 采购价格、货币和计价单位。
- 最小量、最大量和数量步长。
- 可用状态、剩余量和临时暂停标记。
- 对链接、登录名、发布、评论和地区的要求。
- 手动启动、取消、补量和部分完成的标记。
自动导入的不足之处在于,供应商对相同字段的命名各不相同,有时还会传输不完整的数据。服务名称不适合作为稳定关联:供应商可能在不更改外部ID的情况下修改名称。
服务目录请求与响应示例
API格式取决于供应商,但逻辑通常相同:面板传递访问密钥和分页参数,响应中返回服务数组。例如,带游标的目录请求可能如下所示:
GET /api/services?cursor=eyJwYWdlIjoyfQ
假定的API响应:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
不应将响应字段直接写入展示区卡片。首先需要校验它们,保存到供应商目录中,并与内部规则进行映射。仅处理现成卡片的不足之处在于,导入可能会覆盖客户名称、描述或手动选择的类别。
首先在面板中设定分类结构
在导入之前,先确定面板的分类体系。顶层通常描述平台,下一层是操作:订阅者、观看量、反应、评论、直播观众或其他形式。在内部可以按地区、受众类型、速度和补偿条件来划分服务。
为每个类别设定必填特征。对于观看量,可以是链接类型和内容格式;对于订阅者,则是平台、地区和允许的配置文件类型。结构过于细化的不足之处在于,目录维护变得更复杂,而相近的服务开始仅在内部分细节上有所区别。
将供应商与展示区的关联分开存储
供应商服务与面板卡片之间的关联应存储在单独的表中或作为独立实体。其中需要包含供应商、外部ID、内部卡片、类别、价格规则、路由优先级、发布状态和最后成功校验日期。
这种方案允许在不更改卡片URL、不丢失订单历史的情况下更换供应商。JSON中的映射行示例:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

关联可以有不同的形式,但需要为每一种预先确定更新规则。
- 一个供应商服务对应一张卡片,前提是其参数和下单表单唯一。
- 多个不同供应商的服务对应一张卡片,前提是它们在要求和条件上兼容。
- 一个供应商服务对应多张卡片,前提是展示区按语言、细分群体或销售方式对其进行了拆分。
将多个供应商合并到一张卡片中的不足之处在于:速度、可用性和实际执行条件可能不同。不要合并链接格式、限额或必填字段不同的路由。
分页导入目录
供应商可能通过页码、偏移量或游标分页返回目录。第一个响应不一定包含所有服务。持续请求下一页,直到API返回游标、继续链接或其他明确的数据存在标志。
在游标分页下,处理流程如下:面板获取一页,保存所有服务,将它们标记为当前循环中已发现,然后才转到下一个游标。如果缺少next_cursor字段,则视为遍历完成。
- 创建当前同步循环的标识符。
- 请求第一页并保存获取到的服务。
- 为每个服务用循环标识符更新last_seen_sync字段。
- 在执行下一个请求之前保存下一页的游标。
- 成功遍历所有页面后,将目录与当前循环进行比对。
顺序加载页面的不足之处在于,完整导入可能耗时更长。并行请求可以加快过程,但会增加触及API限制或获取到目录不同状态页面的风险。
重复同步时不要创建重复项
要查找现有服务,请使用复合键:供应商标识和服务外部ID。每次重复导入时,先按这对键查找记录,然后更新技术字段。只有在不存在该键时才创建新记录。
不要使用名称、价格或类别进行去重。两个不同的服务可能具有相同的这些值,而供应商可能在不更改外部ID的情况下重命名条目。对于与展示区的关联也需要唯一性控制:同一路由在任务重新运行后不应出现两次。
建议在数据库层面限制唯一性:供应商目录使用supplier_id + external_service_id,映射使用supplier_id + external_service_id + showcase_card_id。严格限制的不足之处在于,如果旧关联出现错误,必须显式修正它,而不能在其上创建新记录。
如何发现已删除和已消失的服务
只有在成功完整遍历所有页面之后,才能将服务视为已消失。如果同步因错误、请求限制或API不可用而中断,则不能将已加载部分目录中缺失的条目标记为已删除。
导入完成后,查找该供应商中last_seen_sync不等于当前循环标识符的服务。将其状态设为“未找到”或“已归档”,禁止用于新订单并发送审核。保留外部ID、变更历史和与订单的关联。
已消失的服务应当归档,而不是删除。供应商可能稍后将其重新加入目录、更改响应过滤器或临时隐藏该条目。如果相同的外部ID再次出现,归档关联可以在下次导入时恢复。
服务外部ID变更时该怎么办
如果供应商创建了新服务来替代旧服务,则不能自动将新的外部ID视为旧ID的延续。即使名称和价格相同,该条目的下单要求、地区、受众类型或补偿条件也可能发生变化。
将旧关联转为归档,停止该路由的销售,并为旧订单保留它。将新服务作为单独记录导入。然后手动创建新的映射,或在技术参数完全兼容的情况下按安全规则创建。
按名称自动匹配可以加快工作,但其不足之处在于,存在将订单发送到条件不合适的其他服务的风险。对于ID变更,最好使用“需要审核”状态,而不是悄悄替换路由。
按稳定的技术字段配置映射
自动分配服务最好基于一组字段构建:平台、服务类型、地区、链接格式、最小量、附加参数和状态。例如,如果API传递了兼容的平台、推广类型和国家值,服务就可以归入按地区划分的观看量类别。
如果供应商要求评论、配置文件列表或手动启动,则不要将路由发布到标准下单表单中。使用带有相应字段的单独卡片,或者在集成完善之前将该服务保持隐藏。
名称只能作为附加特征使用。这种规则的不足之处在于,供应商可能更改措辞、添加缩写或使用其他拼写。关键路由应绑定到外部ID和可校验的响应参数。
将API数据与卡片设置分开
导入不应完全覆盖展示区卡片。采购价格、限额、可用性和技术参数通常从供应商处更新。客户名称、描述、可见性、显示顺序和加价规则则保留为面板的内部设置。
为每个字段指定真实来源。例如,最小量取自API,客户名称取自面板,而展示区价格则根据采购成本按内部规则计算。如果没有这种分离,同步可能会抹掉手动编辑的描述,或根据外部名称更改类别。
检查价格和参数变更
如果供应商更改了价格,请按卡片规则重新计算展示区价格,并检查货币、佣金和允许的利润率。如果价格缺失、货币未知或条件发生明显变化,最好将路由转为审核状态。
当最小量、最大量或数量步长发生变化时,更新下单表单。如果表单不支持新的限制,则停止该路由的销售。否则客户会下单,而供应商在提交后会拒绝。
如果链接格式、必填字段、服务类型或启动方式发生变化,请在手动审核之前阻止新订单。严格阻止的不足之处在于,部分卡片会暂时从展示区消失,但这比接收不兼容的订单更安全。
处理API错误和请求限制
单个请求的错误不应自动禁用整个目录。区分授权错误、请求格式错误、临时不可用和请求频率限制。每组都需要单独的处理方案。
- 出现授权错误时,停止向该供应商发送新订单并检查访问权限。
- 出现请求格式错误时,保存API响应并修复集成,不要无限重试。
- 出现临时错误时,以递增的间隔重试请求。
- 出现频率限制时,保存当前游标并将任务转为重试。
在延迟同步成功完成之前,不要将服务标记为已消失。激进重试的不足之处在于,可能更快耗尽请求限额,并使目录在更长时间内保持过时状态。
为活跃订单保留路由
服务状态和订单状态是不同的实体。服务可能从面向新客户的目录中消失,但基于它的旧订单仍在执行。卡片或路由的归档不应停止对已创建订单的状态轮询。
为每个订单保存服务外部ID、订单外部ID、已发送的参数、启动时的采购成本以及状态历史。如果供应商报告部分完成、取消或错误,请按面板规则处理该情况:退款、补偿、补量或手动审核。
保存订单参数快照的不足之处在于,需要更多空间和更精细的数据方案。如果没有这样的快照,一旦供应商后来更改了服务,就无法确定订单是在什么条件下发送的。
在发布卡片之前测试映射
配置完成后,检查完整路径:在面板中创建订单、选择路由、发送给供应商、保存外部ID、获取状态、取消以及处理部分完成。测试具有不同限额、链接和必填字段的服务组。
单独模拟重复导入、价格变更、成功完整遍历后服务消失、分页中途出错以及请求频率限制。这将显示面板是否会因目录加载不完整而归档正常工作的路由。
特别关注手动服务和带评论的条目。它们的不足之处在于,面板的标准表单往往无法传递供应商期望的所有数据。对于这些服务,需要单独的订单模板,或在API集成完善之前保持隐藏状态。
Last Articles
设计和功能有哪些变化 我们更新了网站,让操作更快捷、更便利。主要变化涉及界面、个人中心和订单管理。 通过优化数据库请求,页面加载速度平均提升了三分之一。导航菜单从页眉移到了左侧边栏,最近订单历史也放到了首页——无需每次都进入个人中心查看状态。 深色主题和自适应 新增了带自动模式的深色主题..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. 使用促销代码 "December2025" 可为我们所有观众享受 15% 折扣2. 在 1 月 1 日前,我们将 配置工具 和最 实惠的观众类别 的基础价格降低了 25%3. 我们的 频道 正在举行 3 个抽奖活动! - 如果您进入我们 购买排行榜 前 100 名,我们将赠送 500..
抽搐服务是 工作稳定,所以我们准备与小队,经销商合作, 服务所有者,机器人所有者和许多其他人。个别条款可以在电报@TiKey_K上与管理员讨论..
我们 已经完全更新了我们的Twitch查看器服务,他们现在是 稳定地工作。 我们只为观众使用高质量的IP地址。细微差别在于多达150名观众的订单。 当总观众数达到200时,它们就会下降.为 例如,如果您订购了140个观众,并且已经拥有100个自己的观众 现场观众,我们的140观众将下..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
由於合作夥伴服務和推薦計劃非常受歡迎,我們製作了一張合作表。本質很簡單:更多的現場觀眾 - 我們提供更多的廣告。下載或查看計劃條款下載集給合作夥伴(簡介 + 標誌)對於主播來說,有必要在直播上放置徽標+添加網站連結。如果不遵守這些規則,則不會提供支援。如果存在欺詐行為,則終身禁止。有關合作夥伴計劃的..
我们的直播主服务

Dlive

Shopee

Bigo
我们的内容创作者服务







