如果你有自己的API接口，可以提交给官方来对接纳入`ThinkAPI`服务，并尽量遵守官方的统一API接口规范。 ## 接口规范 提交的接口尽量满足如下规范（个别情况可以由官方二次封装处理，如果是API供应商则由我们对接处理，不需要按下面规范）： > 统一使用`JSON`格式返回数据； > 返回数据主体包含`message`、`data`和`code`三项； > `code`返回0表示接口调用成功; > 接口返回的业务数据放入`data`数据中； > 尽量支持使用`HTTPS`请求； > 支持异常处理，调用失败支持错误信息（或者错误码）返回； > 付费接口尽量采用单独字段返回计费与否信息（或者code返回0表示计费）； > 接口授权建议使用`key`和`secret`两个属性标记 > 接口传参建议使用驼峰命名，例如`orderId`而不是`order_id` ## 提交接口 ### 第一种：提供API接口 如果你有现成的API接口可以在线调用的，可以直接提供已有API接口地址。 接口提交请发邮件至 `thinkphp@qq.com`，并提供如下接口资料（可以参考现有的API接口）： > 接口名称（25字以内）； > 接口描述（100字以内）； > 接口图片（250*250）； > 请求地址及请求类型； > 请求参数和返回数据（参考已有的API文档）； ### 第二种：接口服务平台 如果你是接口服务商（或平台），有大量接口需要提交对接的，我们会安排专人进行对接测试，无需你们做任何的调整，可直接联系微信`topthink`咨询商务及对接事宜。 无论选择何种方式都可以享受接口的调用分成机制（按实际调用次数计算，免费接口除外），详情咨询微信`topthink`。官方会对提交的接口进行测试及评估，但可能由于种种原因无法保证一定能收录您提交的接口。 >[danger] 如果是收费接口请提供一定数量的测试次数便于官方对接测试，由于稳定性原因，暂不支持个人付费接口的接入。