Welcome Guest ( Log In | Register )

欢迎访问本站。游客仅能浏览首页新闻、版块主题、维基条目与资源信息，需登录后方可获得内容发布、话题讨论、维基编辑与资源下载等权限。若无账号请先完成注册流程。
显示源文件修订记录 最近更改
 
搜索
 
目录

目录

 
索引
trow:api:start

Legal Statement

  • 一旦使用本服务，表明您已同意下述条款；若违背以下条款，本站有权随时封禁服务或采取法律措施
    1. 不得使用本服务及由此获取的本站数据进行任何违法或不正当活动
    2. 用户在本站发布或产生的数据由用户及本站共同所有，任何其他组织或个人未经授权同意，不得复制或擅改内容
    3. 特别地，不得利用本服务来进行填充商业或个人站点等任何行内容采集之实的活动
  • 在不违反上述条款的情况下，利用本服务进行盈利的行为是允许的，但需要先 联系管理员 进行报备并获取许可

Introduction

  • 返回数据一律使用 JSON 格式，XML 格式有支持计划但优先级很低
  • 请使用 HTTPS 调用接口以规避潜在的安全风险，否则可能会无法正常访问
  • 为保证安全性，API 不允许 JavaScript 跨域访问，请在服务端调用
  • 状态码统一返回 200，请自行判断数据内是否有 error 字段，若存在则表示出现错误
    • 响应中的 HTTP 头字段 X-User-Id 记录了当前访问者的用户 Id 值，0 为游客
    • 频率限制请查看 API Rate Limit 部分
  • 服务端形式的第三方应用请注意设置 X-Forwarded-For，以便（未来的）统计功能获取客户端的真实 IP
    • 服务端前的反向代理 / CDN（如果有）本身也应进行恰当设置，确保将真实 IP 传递给服务端
  • 问题反馈与开发建议等相关讨论请移步 T.R.O.W. API Discussion

API Rate Limit

  • 默认每个 IP 每 15 分钟内可以发起 30 个 API 请求，请第三方开发者酌情考虑添加缓存机制
  • 响应中的 HTTP 头字段（X-Ratelimit-*）记录了关于当前可用额度的各种信息

Documentation


trow/api/start.txt · 最后更改: 2019/12/17 16:45 由 inthel
 
显示源文件修订记录 到顶部
Copyright © 2005-2020 The Ring of Wonder Time is now: 2020-09-25, 12:21