| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| func | string | 是 | 查询功能的代号, 每个功能都有自已的独用自符串 |
| site | string | 是 | 必需encode传递,有的功能支持域名,如果传入网址,接口会自动提取出域名。 |
| id | int | 是 | 用户的id号,可在后台获得 |
| sign | string | 是 | 签名,32位md5字符串; 不加密传输:需指定 signtype=1,直接使用后台获得的key当签名使用; 加密传输:请参考下方"sign签名生成规则" |
| signtype | int | 否 | 指定 signtype=1 时,签名可直接使用原始key字符串,即不加密传输; signtype为空 或 任何其他值,都当作加密传输; |
1、签名=用户id:用户key:site中提取出来的域名; 公式如下:sign=md5(id:key:域名)
2、签名中的域名不能带http://, 仅保留域名部分,如:xx.xxx.com
3、id和key在用户后台可以获得;
4、签名用于确定查询用户是否已授权; 传输过程为防止key泄露,用采了简单的md5加密; 可查看上方的PHP示例代码;
1、site表示被查询的网址或域名,传输前必需encode;
2、可传递任意网址,接口智能识别; 有的功能只支持域名,也可以传递内页url,接口会自动提取出域名,并返回正确结果。例如:百度权重值,仅域名有百度权重值,内页是没有权重值的,如果传递xxx.xxx.com/xxx.html,接口会自动识别出域名,用户无需处理。
3、不支持IP地址;
| 名称 | 类型 | 说明 |
|---|---|---|
| status | string | 查询的状态,仅当本值==1时,才表示成功查询 |
| result | object | 仅当status==1时,才会有result对象(数组); result下面有data元素 |
| data | mix | 本元素存放返回结果核心数据,例如:百度权重,本元素为权重值、百度快照,本值就是快照日期; 少数功能还会返回辅助元素,详情请查询各个不同功能的页面。 |
{
"status": "1",
"result": { //仅在status=='1'时,才会有result元素
"data": "查询结果" //每个查询项都会有data元素,小部分查询项还会有其他元素;
}
}
| 代号 | 类型 | 说明 |
|---|---|---|
| 1 | int | 成功查询,仅本返回值才是成功查询,且仅在本状态下才会扣减积分 |
| -1 | int | 失败:未获得预期结果 |
| -2 | int | 短时间暂停(一般为2分钟); 单项功能如果一直查询失败,此项功能会返回本值(其他查询项不受影响),主要为了防止单功能失效导致服务器过载; |
| -3 | int | 该功能已停用:一些以前开通了的功能,由于不可抗拒因素导致不能再次对外开放使用,会返回本值 |
| -4 | int | 不支持域名或后辍,一些新后辍域名,未必能及时得到支持,仅"建站时长"功能才会有本返回值 |
| -5 | int | 未定义的功能标识:错误的功能标识,会返回本值。 |
| -6 | int | 网址有危险字符:一些具有入侵性的查询网址,会返回本值; 仅支持任意url的功能会有本返回值,如:查询标题、快照日期等。 |
| -10 | int | 积分不足:账户已经不够积分了,有充足积分会自动解除。 |
| -11 | int | 签名非法:sign签名非法。注意:签名不是key 请查看上方的Sign签名生成规则。 |
| -12 | int | 并发过大:每个功能每秒只支持100次调用,超出就会返回本值 |