描述: 将长网址缩短为短网址
优势:
- 支持跨域
- 采用安全可靠的https协议
- 免费
- 永久
- 请注意:使用协议随项目开发会有些许修改,您使用接口表示同意相关协议!
请求:
请求地址: https://open.saintic.com/openservice/shorturl/v1/
请求方法: POST
请求参数:
Action: 值固定为shorten,即缩短网址
请求示例:
curl -sL https://open.saintic.com/openservice/shorturl/v1/?Action=shorten -XPOST -d long_url=https://open.saintic.com -d jid=自定义URL
响应:
响应参数:
msg: 失败时的错误信息
code: 0是请求成功,其他请求失败
data: 字典,包含short_url为短网址,shorten为唯一标识码
响应示例:
{"code": 0, "data": {"short_url": "https://xxx/6", "shorten": "6"}, "msg": null}
描述: 用于获取并返回必应今日美图
优势:
- 支持跨域
- 支持多分辨率
- 采用安全可靠的https协议
- 可写入css样式 background-images等
请求:
请求地址: https://open.saintic.com/api/bingPic/
请求方法: GET
请求参数:
picSize: 分辨率:1表示1366x768, 2表示1920x1080
请求示例:
https://open.saintic.com/api/bingPic/
<img src='https://open.saintic.com/api/bingPic/' />
响应:
重定向至今日美图地址
描述: 用于获取并返回百度的收录实况
优势:
- 支持跨域
- 缓存查询结果(首次查询大约0.5~2s,如收录,则缓存,之后秒开)
- 采用安全可靠的https协议
- 查询结果准确性非常高
请求:
请求地址: https://open.saintic.com/api/BaiduIncludedQuery/
请求方法: GET
请求参数:
请求示例:
curl -sL https://open.saintic.com/api/BaiduIncludedQuery/?url=https://www.saintic.com/
响应:
响应参数:
url: 原样返回请求查询的地址
msg: 响应信息
code: 同Included, 0是收录,其他是异常
Included: 是否收录, true:收录, false:未收录
响应示例:
{"Included": true, "code": 0, "msg": null, "url": "https://www.saintic.com/"}
描述: 黄赌毒、木马后门钓鱼等危险网址查询接口
优势:
- 支持跨域
- 采用安全可靠的https协议
- 数据源来自腾讯安全和360网址安全披露
- 数据采集每日更新
请求:
请求地址: https://open.saintic.com/api/dangerurl
请求方法: GET
请求参数:
Action: 可选。
queryALL表示查询所有危险数据,可配合onlyURL=1使用。
checkURL配合url参数表示检查url是否是危险网址。
请求示例:
curl -sL https://open.saintic.com/api/dangerurl?Action=queryALL&onlyURL=1
响应:
响应参数:
msg: 失败时的错误信息
code: 0是请求成功,其他请求失败
data: Action=queryALL时,onlyURL=1,data是数组,否则是字典。Action=checkURL时,code=0表示是危险网址,data是字典,url具体信息。
响应示例:
{"code": 0, "data": ["http://3yaeck.cn", "http://www.bfxwlw.cn"], "msg": null}
描述: 查询上下几次运行时间或创建以来运行次数
优势:
- 支持跨域
- 采用安全可靠的https协议
- 查询结果准确性非常高
请求:
请求地址: https://open.saintic.com/api/CronTime/
请求方法: GET
请求参数:
Action: str类型,公共参数,代表动作行为。
CrontabNextPrevTime:查询上下几次运行时间;
CrontabRunTimes:查询创建以来运行次数
queryTimes: int类型,Action值为CrontabNextPrevTime的参数,代表查询以后或之前几次运行
expression: str类型,公共参数,定时任务时间表达式
ctime: str类型,Action值为CrontabRunTimes的参数,定时任务创建的时间,符合`%Y-%m-%d %H:%M:%S`格式
reqType: str类型,Action值为CrontabNextPrevTime的参数,代表查询类型,next:之后 prev:之前,分水岭当前时间
请求示例:
curl -sL 'https://open.saintic.com/api/CronTime/?Action=CrontabNextPrevTime&expression=00+04+*%2f30+*+*&queryTimes=2&reqType=prev'
requests.get('https://open.saintic.com/api/CronTime/',params=dict(Action='CrontabRunTimes', expression='*/15 * * * *', ctime='2017-11-26 00:00:00')).json()
响应:
响应参数:
msg: 响应信息
data: Action值为CrontabNextPrevTime时返回list列表数组,代表上下几次运行的时间;Action值为CrontabRunTimes时返回int数字,代表运行的次数。
success: 返回bool类型,true:请求正确并返回, false:请求发生异常、异常信息见msg
响应示例:
{"data": ["2017-11-01 04:00:00", "2017-10-31 04:00:00"], "msg": null, "success": true}
{"data": 156, "msg": null, "success": true}
描述: 将短网址还原为长网址
优势:
- 支持跨域
- 采用安全可靠的https协议
- 免费
- 匿名
- 永久
- 请注意:使用协议随项目开发会有些许修改,您使用接口表示同意相关协议!
请求:
请求地址: https://open.saintic.com/openservice/shorturl/v1/
请求方法: POST
请求参数:
Action: 值固定为reduction,即还原网址
请求示例:
curl -sL https://open.saintic.com/openservice/shorturl/v1/?Action=reduction -XPOST -d short_url=https://xxx/6 or short_string=6
响应:
响应参数:
msg: 失败时的错误信息
code: 0是请求成功,其他请求失败
data: 字典,包含long_url为长网址,shorten为唯一标识码,status为状态
响应示例:
{"code": 0, "data": {"long_url": "https://open.saintic.com", "realname": "0", "safe": "1", "shorten": "6", "status": "1"}, "msg": null}
描述: 用于获取并返回必应的收录实况
优势:
- 支持跨域
- 缓存查询结果(首次查询大约0.5~2s,如收录,则缓存,之后秒开)
- 采用安全可靠的https协议
- 查询结果准确性非常高
请求:
请求地址: https://open.saintic.com/api/BingIncludedQuery/
请求方法: GET
请求参数:
url: 需要查询的地址
method: 查询的方法,可选值rss、html,默认先使用rss查询,失败时再用html查询,建议rss方式,效率更高
请求示例:
curl -sL https://open.saintic.com/api/BingIncludedQuery/?url=https://www.saintic.com/
响应:
响应参数:
msg: 异常信息
success: bool类型,表示是否收录成功, true:收录, false:未收录
响应示例:
{"msg": null, "success": true}