诏预

#长网址缩短接口

描述： 将长网址缩短为短网址
优势： 

• 支持跨域
• 采用安全可靠的https协议
• 免费
• 永久
• 请注意：使用协议随项目开发会有些许修改，您使用接口表示同意相关协议！

请求： 
      请求地址: https://open.saintic.com/openservice/shorturl/v1/
      请求方法: POST
      请求参数: 

• Action: 值固定为shorten，即缩短网址

      请求示例: 

• 请先在passport登录接口获取Token，并携带Token作为cookie请求此接口！
• curl -sL -XPOST https://passport.saintic.com/api/user/login -d account=本地化账号 -d password=密码 -d fields=token
• 上述验证通过后返回数据中有token字段，然后再请求下列接口：
• curl -sL -XPOST --cookie sessionId=上述接口返回的Token值 https://open.saintic.com/openservice/shorturl/v1/?Action=shorten -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}

#Bing今日美图

描述： 用于获取并返回必应今日美图
优势： 

• 支持跨域
• 支持多分辨率
• 采用安全可靠的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/' />

响应： 
      重定向至今日美图地址 

#百度收录查询

描述： 用于获取并返回百度的收录实况
优势： 

• 支持跨域
• 缓存查询结果
• 采用安全可靠的https协议
• 查询结果准确性非常高

请求： 
      请求地址: https://open.saintic.com/api/BaiduIncludedQuery/
      请求方法: GET
      请求参数: 

• url: 需要查询的地址
• method: 查询的方法，可选值json、html，默认先使用json查询，失败时再用html查询

      请求示例: 

• curl -sL https://open.saintic.com/api/BaiduIncludedQuery/?url=https://www.saintic.com/

响应： 
      响应参数: 

• url: 原样返回请求查询的地址
• msg: 响应信息
• code: 同Included, 不过是int类型，0是收录，其他是异常
• success: 同Included, true:收录, false:未收录
• Included: Boolean类型，表示是否收录, true:收录, false:未收录

      响应示例: 

• {"Included": true, "code": 0, "msg": null, "success": true, "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}

#必应收录查询

描述： 用于获取并返回必应的收录实况
优势： 

• 支持跨域
• 缓存查询结果
• 采用安全可靠的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}