诏预

OpenApi

    #长网址缩短接口

    描述: 将长网址缩短为短网址
    优势: 
    • 支持跨域
    • 采用安全可靠的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/' />
    响应: 
          重定向至今日美图地址 

    #K站随机动漫壁纸

    描述: K站(konachan.net/konachan.com)随机二次元风格PC端壁纸
    优势: 
    • 支持跨域
    • 允许切换壁纸来源的net/com站点
    • 采用安全可靠的https协议
    • 可写入css样式 background-images等
    请求: 
          请求地址: https://open.saintic.com/api/kPic/
          请求方法: GET
          请求参数: 
    • r18: 值为true表示请求konachan.com,默认是false即请求konachan.net;至于区别,嗯,com是R18级别,慎用!
    • noCache: 值为true表示不缓存,即每次请求都重新获取随机动漫壁纸,默认是false(缓存1h)
          请求示例: 
    • https://open.saintic.com/api/kPic/
    • <img src='https://open.saintic.com/api/kPic/' />
    响应: 
          重定向至动漫壁纸地址 

    #百度收录查询

    描述: 用于获取并返回百度的收录实况
    优势: 
    • 支持跨域
    • 缓存查询结果
    • 采用安全可靠的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/"}

    #IP查询接口

    描述:  查询IP信息及提供RESTApi
    优势: 
    • 支持跨域
    • 采用安全可靠的https协议
    • 免费
    • 永久
    • 请注意:使用协议随项目开发会有些许修改,您使用接口表示同意相关协议!
    请求: 
          请求地址: https://open.saintic.com/ip/rest
          请求方法: GET
          请求参数: 
    • ip: 默认为访问者IP,可通过此参数设置为其他值。
          请求示例: 
    • curl https://open.saintic.com/ip/rest
    • 实际上 /ip 下还有其他接口
    • /ip/myip 仅查询访问者IP;
    • /ip/addr 查询访问者IP及信息,可用查询参数 ip 改为查询其他值。
    响应: 
          响应参数: 
    • message: 失败时的错误信息
    • data: 成功时返回IP信息,包括国家、省市、ISP等。
    • success: true是请求成功,false请求失败
          响应示例: 
    • {"data": {"city": "\u5317\u4eac\u5e02", "country": "\u4e2d\u56fd", "ip": "123.120.217.159", "isp": "\u8054\u901a", "province": "\u5317\u4eac"}, "message": "ok", "success": true}

    #危险网址查询

    描述: 黄赌毒、木马后门钓鱼等危险网址查询接口
    优势: 
    • 支持跨域
    • 采用安全可靠的https协议
    • 数据源来自腾讯安全和360网址安全披露
    • 数据采集每日更新
    请求: 
          请求地址: https://open.saintic.com/api/dangerurl
          请求方法: GET
          请求参数: 
    • Action: 可选。
      checkURL配合url参数表示检查url是否是危险网址。
          请求示例: 
    • curl -sL https://open.saintic.com/api/dangerurl?Action=checkURL&url=https://www.saintic.com
    响应: 
          响应参数: 
    • msg: 失败时的错误信息
    • code: 0表示是危险网址,其他则暂未收录或非危险
    • data: code=0表示是危险网址,data是url信息
          响应示例: 
    • {"code": 1, "msg": "Not found such url"}

    #定时任务查询

    描述: 查询上下几次运行时间或创建以来运行次数
    优势: 
    • 支持跨域
    • 采用安全可靠的https协议
    • 查询结果准确性非常高
    请求: 
          请求地址: https://open.saintic.com/api/CronTime/
          请求方法: GET
          请求参数: 
    • Action: str类型,公共参数,代表动作行为。
      CrontabNextPrevTime:查询上下几次运行时间
    • queryTimes: int类型,Action值为CrontabNextPrevTime的参数,代表查询以后或之前几次运行(最大32)
    • expression: str类型,公共参数,定时任务时间表达式
    • reqType: str类型,Action值为CrontabNextPrevTime的参数,代表查询类型,next:之后 prev:之前,分水岭当前时间
          请求示例: 
    • curl -sL 'https://open.saintic.com/api/CronTime/?Action=CrontabNextPrevTime&expression=00+04+*%2f30+*+*&queryTimes=2&reqType=prev'
    响应: 
          响应参数: 
    • msg: 响应信息
    • data: Action值为CrontabNextPrevTime时返回list列表数组,代表上下几次运行的时间
    • success: 返回bool类型,true:请求正确并返回, false:请求发生异常、异常信息见msg
          响应示例: 
    • {"data": ["2017-11-01 04:00:00", "2017-10-31 04:00:00"], "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}