Metin2-Help记录并验证投票结果. 您的服务器网站识别玩家,在自己的系统中给予奖励并确认处理. 我们没有收到游戏证书,也不改变硬币或物品。
Apache、Nginx、Laravel、WordPress和Cloudflare 的指南
提交、批准的出版物、表决、标准部件和基本API是免费的。 没有订阅。
- 注册服务器 — 签收的账号填写表格,报送审查或者作为草案保存.
- 校验域 — 在 /. well-nown/metin2-help-verify.txt 或在 DNS TXT 记录中公布此令牌. 主持人可以手动确认.
- 获得批准 — 只有经过验证的所有权得到批准的服务器才能生成API密钥.
- 生成密钥 — 密钥显示一次。 存储在服务器上, 而不是玩家浏览器中。
- 安装脚本 — PHP的例子创造了一种意图,并分别读取无人认领的选票.
- 创建意图 — 您的网站发送玩家标识符并接收带有不透明符号的 URL。 信物在30分钟后失效.
- 发送玩家 — 玩家在Metin2-Help和选票上签名. 打开 URL 不是表决。
- 检查选票 — 您使用服务器密钥查询无人认领的选票。
- 赏金给你 — 您在自己的数据库或系统中给予它。 Metin2-Help不给予它。
- 确认 — 你发送处理过的投票身份证。 重复同样的确认不会产生第二次收据。
- 错误后重试 — 如果确认书没有到来,投票会一直无人认领,你可以重试. 给游戏的交付并非一成不变。
- 旋转密钥 — 旋转立即取消旧密钥. 在下一次呼叫前更新脚本。
API
POST /api/v1/servers/{public_id}/vote-intentsGET /api/v1/vote-intents/{intent_id}GET /api/v1/servers/{public_id}/votes/unclaimedPOST /api/v1/servers/{public_id}/votes/claimGET /api/v1/servers/{public_id}/statsGET /api/v1/servers/{public_id}/integration
我在网站上装什么?
- 在编辑页面上显示的服务器公共ID.
- API 密钥, 只有在生成时才保存在您的后端。
- 普通投票链接,可以生活在HTML按钮中,不识别玩家.
- 奖励票流 需要你的后台
- PHP 例子, 您可以适应本地奖励。
- 下方为API端积分.
- 地方奖励录制完毕后,无人认领的选票查询和申领.
选票链接
它可以放在HTML按钮中. 它不包含玩家ID,也不自行给予奖励.
奖励投票
- 您的网站识别签名的玩家。
- 它通过 API 创建意图并获得选票 url。
- 它使玩家重新定向投票 url. 开始表决不是表决。
- 投票后,你询问无人认领的选票。
- 你在自己的系统中给予奖励 并在当地通过投票证记录。
- 你确认处理。 重复同样的确认不会产生第二个记录.
已声明仅表示 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和身体上. 投票仍然是回收方法。 我们不向内部地址发送。
带薪晋级不活跃,不改变投票顺序.