出于系统调优目的,去年今日我们微调了全站接口的公共参数和JSON结构,优化了自2015年至今遗留的一些问题,并上线了新的接口域名(apis.tianapi.com)。
目前,老接口域名(api.tianapi.com)继续正常提供服务,但随着时间推移,老接口域名综合效率性能等将会逐年下降,且一些新产品、功能特性等也不再维持同步更新。因此建议各位开发者在下次更新迭代产品时,及时将接口域名调整为新域名,并根据新的接口文档略调部分公共参数。主要为newslist[]数组调整为result{}对象,具体可查看接口新增APIS域名及优化数据结构。
如下图中机器人接口返回json结构差异:
怎么分辨我用的新接口域名还是老接口域名?
1、最直接的办法就是看项目里请求接口的域名,api开头的二级域名是老接口域名,apis开头的是新接口域名。
2、看控制台数据管理 - 接口请求日志,顶层一个中括号[]为老域名的json结构,顶层是花括号{}则为新域名的json结构。
3、2022年11月8号后全站接口文档、示例等都改成了新接口域名,如果您再此之后注册的则应该用的新域名。
此外,您也可以在控制台右上角发起工单,让客服帮忙分辨。
不调整继续用老接口域名有哪些弊端?
1,老接口域名不支持2022年11月后上线的新接口,用老域名请求新接口会返回404错误。
2,不再对老域名下的API进行升级优化,仅维持正常工作。且出现Bug时老域名相对慢一些。
3,公告维护期过后,仅维持单例架构,负载变高。且免费会员将可能无法通过老域名调用数据。
有哪些注意事项?
1,建议不要新老域名混用。要么暂且用老接口域名,要么统一更改为新接口域名。
2,即日起免费会员调用会员类接口,旧接口域名为1QPS,新接口域名为10QPS。
3,新老域名同一出口IP,仅返回的json公共参数结构略有变化,其他完全相同。
4,老域名公告维护周期至2024年12月31号。建议在此之前完成替换。
5,高级会员以上用户,会员有效期内不受以上条件限制,到期后可继续使用。
客服将会在到期前,通过多种方式发送提醒消息。其他有关具体情况可查看《接口新增APIS域名及优化数据结构》