投票一体化

Metin2-Help记录并验证投票结果. 您的服务器网站识别玩家,在自己的系统中给予奖励并确认处理. 我们没有收到游戏证书,也不改变硬币或物品。

Apache、Nginx、Laravel、WordPress和Cloudflare 的指南

提交、批准的出版物、表决、标准部件和基本API是免费的。 没有订阅。

  1. 注册服务器 — 签收的账号填写表格,报送审查或者作为草案保存.
  2. 校验域 — 在 /. well-nown/metin2-help-verify.txt 或在 DNS TXT 记录中公布此令牌. 主持人可以手动确认.
  3. 获得批准 — 只有经过验证的所有权得到批准的服务器才能生成API密钥.
  4. 生成密钥 — 密钥显示一次。 存储在服务器上, 而不是玩家浏览器中。
  5. 安装脚本 — PHP的例子创造了一种意图,并分别读取无人认领的选票.
  6. 创建意图 — 您的网站发送玩家标识符并接收带有不透明符号的 URL。 信物在30分钟后失效.
  7. 发送玩家 — 玩家在Metin2-Help和选票上签名. 打开 URL 不是表决。
  8. 检查选票 — 您使用服务器密钥查询无人认领的选票。
  9. 赏金给你 — 您在自己的数据库或系统中给予它。 Metin2-Help不给予它。
  10. 确认 — 你发送处理过的投票身份证。 重复同样的确认不会产生第二次收据。
  11. 错误后重试 — 如果确认书没有到来,投票会一直无人认领,你可以重试. 给游戏的交付并非一成不变。
  12. 旋转密钥 — 旋转立即取消旧密钥. 在下一次呼叫前更新脚本。

API

  • POST /api/v1/servers/{public_id}/vote-intents
  • GET /api/v1/vote-intents/{intent_id}
  • GET /api/v1/servers/{public_id}/votes/unclaimed
  • POST /api/v1/servers/{public_id}/votes/claim
  • GET /api/v1/servers/{public_id}/stats
  • GET /api/v1/servers/{public_id}/integration

我在网站上装什么?

  1. 在编辑页面上显示的服务器公共ID.
  2. API 密钥, 只有在生成时才保存在您的后端。
  3. 普通投票链接,可以生活在HTML按钮中,不识别玩家.
  4. 奖励票流 需要你的后台
  5. PHP 例子, 您可以适应本地奖励。
  6. 下方为API端积分.
  7. 地方奖励录制完毕后,无人认领的选票查询和申领.

选票链接

它可以放在HTML按钮中. 它不包含玩家ID,也不自行给予奖励.

奖励投票

  1. 您的网站识别签名的玩家。
  2. 它通过 API 创建意图并获得选票 url。
  3. 它使玩家重新定向投票 url. 开始表决不是表决。
  4. 投票后,你询问无人认领的选票。
  5. 你在自己的系统中给予奖励 并在当地通过投票证记录。
  6. 你确认处理。 重复同样的确认不会产生第二个记录.

已声明仅表示 Metin2-Help 记录确认。 它不能证明当地给予的奖励。 你独有的选民身份证日记就是证明 如果奖励和日记共享数据库,请将它们保存在一个交易中。 如果无法做到这一积分,请从日记中恢复;这并非是游戏中完全一次性的交付。

Vote4Coins型系统

服务器集成页面上的Vote4Coins链接有https://metin2-help.com/api/vote/{public id}/{token}/ID格式. 符号不是 API 键。 替换ID打开该账户的页面,但不会产生投票意图,也不会确认奖励. 如果ID保持不变,投票不附在玩家身上. 一个确认的奖励需要高级连接。

有些网站只接受一个形状为https://your-website/api/vote4coins/callback/INDEX?username=PLAYER&key=SECRET的回调. 这种形状就是一个例子。 这不是Metin2-Help的终积分,也不是真正的关键。

Metin2-Help 不自动调用任意所有者的回调。 目前的API使用投票意向,验证投票,投票和权利主张确认.

一个只接受召回URL的系统需要在所有者的后端或明确的协议支持上有一个适配器. Metin2-Help 不更改您的网站,也不访问游戏数据库.

自定义 PHP:实例脚本可以按要求运行,也可以从cron运行. Laravel:计划命令中相同的HTTP客户端. Cron:民意调查并在当地期刊录制奖励后确认.

在不改变游戏核心的情况下,可以将日记和奖励保存在您控制的数据库中. 输入游戏账户仍然是你的密码

不同的术语

投票 URL. 玩家为投票打开的页面. 简单的投票使用公共页面. 奖励票使用返回后端的选票,带有不透明的符号.

API 验证 URL. 您的网站结束积分询问投票是否存在。 在 Metin2-Help 上,这是在信头中带有密钥的 API,而不是包含密钥的 URL。

回电. 某个外部系统在投票后会拨打的地址 Metin2-Help 不自动调用其他软件中选择的回调。

后退. 相同的逆向呼叫,经常是访问您的网站。 Vote4Coins 表格可能显示它自己的后台,而不是您输入的投票链接。

玩家标识. 服务器网站的账户标识符。 在Vote4Coins链接中,它仅在ID部分完成替换时才替换. 在高级集成中,后端作为玩家 ref发送. Metin2-Help 不检查游戏中是否存在.

用户名. 如果这是您使用的标识符, 它可以和玩家 ref 相同。 Metin2-Help 不检查游戏中是否存在.

API 密钥. 您的后端用于认证到 Metin2-Help 的秘密。 它显示一次,没有进入 HTML。

回调密钥. 你网站上属于这个系统的秘密 这不是Metin2-Help API键,它不应该发送给我们。

投票意向. 将玩家与尚未进行的投票联系起来的临时记录.

索赔. 你确认你办理了选民证 它本身并不能证明游戏得到的奖励。

Vote4Coins 可确定什么

Vote4Coins这个名称涵盖多个执行,有不同的协议. Metin2-Help没有单一的公共合同可以宣布兼容.

有的将 POST JSON 拖到由主人配置的回调,带有一个使用符,一个时间戳和一个散列. 其他人则期望拥有者网站查询一API并收到0或1. 其他的则在所有者域上为每次注册生成一个召回端积分.

显示地址的表格,如https://your-website/api/vote4coins/callback/0?username=SECRET 显示您网站的终积分。 它们不是输入的投票链接,也不是Metin2-Help的终积分。 不同行的不同密钥与本地生成的秘密一致,每行一个.

这一观察没有在私人网站面板上检查,也没有向这些地址提出请求。 不要把它作为每个安装的描述.

Metin2-Help 不调用这些回调。 其自己的webhook是独立的,可选的,默认关闭的,只有HTTPS,只保存到服务器编辑器中保存的地址,有HMAC签名. 它不取代 Vote4Coins 邮资。

如果您的安装可以调用带有X-API-Key头的HTTPS API,请将后端调整为上面的合同. 如果它只接受自召回时收到的回信,您需要在您的网站上有一个适配器:适配器用Metin2-Help检查投票结果,然后才能通知本地系统. Metin2-Help没有打电话

要了解您的安装能做什么, 请检查它的文档: 它是否接受 HTTP 客户端并带有自定义头条, 只有投票 URL, 或只接受入境后退。 没有这种细节,这种一体化就不能称为有效。

我该复制什么,在哪里?

A,我只想要排名的选票. 复制简单的公共链接或部件。 不复制 API 密钥。

B. 我有一个PHP网站 可以改变后端. 将密钥和公用ID放到服务器配置中,然后使用PHP的例子:意图,投票 url,无人认领的选票,当地奖励,主张.

C,我有Vote4Coins,可以叫定制API. 你的后端必须适应Metin2-Help合同. 不要将密钥粘贴到召回字段。

D,我有Vote4Coins,只接受退货. Metin2-Help不称后卫. 在您的网站上没有适配器, 自动奖励无法获取。

E. 我不能改变网站代码. 您可以粘贴 Vote4Coins 链接到已有的字段。 如果网站没有替换ID,投票不与玩家挂钩. 得到确认的奖励与高级整合有关。

Vote4Coins 链接和标识符

链接以ID结尾. 一个取代ID的网站打开了该账户的页面,但并不产生投票意向. 保持ID不变的网站不附加玩家. 链接中的符号不是 API 键。 获得确认的奖励与高级连接有关:网站创建的意图、确认的投票和主张。

简单投票:玩家打开页面和投票,不附玩家ID.

奖励投票:你的网站创建意图,确认后只给予你一方的奖励.

POST /vote-intents

{
  "player_ref": "Hero.1",
  "idempotency_key": "player-hero-1-try"
}
{
  "intent_id": "0123456789abcdef01234567",
  "vote_url": "https://metin2-help.com/servere/{slug}/vot/{token}",
  "expires_at": "2026-11-14 02:00:00",
  "status": "pending"
}

POST /votes/claim

{ "vote_ids": [120] }
{ "data": [{ "vote_id": 120, "result": "claimed" }] }

401表示键丢失或错误. 403指另一个服务器,未经批准的服务器或未经验证的所有权. 404是一个缺失的意图。 422是一个无效的识别符. 429是利率限制.

网页浏览器是可选的, 在启用前不要关闭。 签名为HMAC-SHA256在时间戳,非ce和身体上. 投票仍然是回收方法。 我们不向内部地址发送。

带薪晋级不活跃,不改变投票顺序.

下载 PHP 示例

下载 PHP 示例