接口新增APIS域名及优化数据结构

栏目分类:平台资讯 发布时间:2022-11-08 阅读次数:12987

新启用的接口域名优化了自2015年至今的一些遗留问题,以及对其他各方面都进行了升级。如果您当前请求接口用的是老域名(api.tianapi.com),建议在下次项目迭代时更换到apis.tianapi.com新域名,并重新查看接口文档略调接口返回的公共参数(主要为newslist[]数组调整为result{}对象)。同时,老域名将延期维护到2025年10月,之后将根据实际情况作出调整并发布公告,建议关注“天行数据云服务”微信公众号。


早期平台内所有接口返回的JSON数据都是封装在newslist这个特殊数组中。本次优化对新域名下的JSON数据结构进行了调整,更加语义化。新老域名返回结果集(列表)时结构对比,点击图片放大查看:


新增接口域名调整部分数据结构


新老域名返回结果项(单个)时结构对比:


新增接口域名调整部分数据结构


新域名当接口返回的数据是结果项时可以直接result[key]方式调用,如果含有结果集时会嵌套在result对象下的list数组中。


新域名返回结果集时数据结构:


{
  "code": 200,
  "msg": "success",
  "result": {
    "list": [
      {
        "id": "0decc4d9b8cde282",
        "ctime": "2015-07-17",
        "title": "那个抱走王明涵的,你上微信吗?看完这个你会心软吗?",
        "description": "中国传统文化",    
        "type": "学霸族"
      }
         ]
   }
}


新域名单结果项时数据结构:


{
  "code": 200,
  "msg": "success",
  "result": {
    "reply": "亲爱的主公你好,我叫小天!",
    "datatype": "text"
  }
}


接口文档已全部更新为新域名示例,新老域名公共参数有较大差异,应用参数基本一致。


以PHP代码举例,新域名的调用方式:


社会新闻等API返回结果集时,将原来的遍历数组$data['newslist']替换成$data['result']['newslist']:

$data = json_decode($tianapi_data,true);      //将json解析成php变量
foreach($data['result']['newslist'] as $list) {  //遍历数组数据集,新域名列表在result对象下的newslist或list数组中
        echo $list['title'];        //输出新闻标题
}


天行机器人等API返回单结果项时,将原来的$data['newslist'][0]['reply']替换成$data['result']['reply']:

$data = json_decode($tianapi_data,true);   //将json解析成php变量
echo $data['result']['reply'];        //输出机器人回复,新域名单行数据集直接包含在result对象中


新旧域名的主要差异如下表:



旧域名api.tianapi.com新域名apis.tianapi.com
接口返回的JSON数据结构数据包含在newslist[]数组中,例如:{"newslist":[{"title":"标题"}]}数据包含在result{}对象中,例如:{"result":{"title":"标题"}},结果集则嵌套在result对象下的list[]数组中
是否支持2023年后上线的接口不支持支持
接入点(接口的功能集合)①兼容一个主接入点全部接入点
接口功能升级或新增应用参数不增加增加
普通会员调用免费接口频率2QPS10QPS
维护周期

2025.10.01后(逐步停止维护)②

永久

① 同一个接口的不同功能组通过不同接入点实现

② 付费会员、计次类接口暂不受维护周期影响



其他提示:

以快递接口为例,老域名的接口URI主要有以下三种形式,均可使用: 

1,https://api.tianapi.com/kuaidi/
2,https://api.tianapi.com/txapi/kuaidi/index
3,https://api.tianapi.com/kuaidi/index


新域名的全部接口统一为以下URI形式:

1,https://apis.tianapi.com/kuaidi/index


新老域名只有返回数据的json结构公共参数部分略有调整,其他如出口IP等均无任何变化。

系统将会在维护周期结束前,通过微信服务号(天行数据云服务)、EMail等方式发送提醒。

其他推荐OTHER API 更多>

开通会员专享福利
工单 客服