诏预

# Bing今日美图（新版）

描述： 用于获取并返回必应美图（当天或指定日期）
优势： 

• 支持跨域
• 采用安全可靠的https协议
• 支持多分辨率，720p、1080p、4k
• 支持当天美图和指定日期美图（仅可指定上线时间20250606及之后）
• 支持返回JSON格式（默认重定向到图片地址）
• 可写入css样式 background-images等

请求： 
      请求地址: https://hub.saintic.com/openservice/bingpic
      请求方法: GET
      请求参数: 

• mobile: 是否为移动端，只要存在该参数即返回移动端图片（4k不支持），默认返回桌面端图片
• p: 返回图片的分辨率：支持：720p、1080p、4k，默认1080p
• json: 是否返回JSON格式，只要存在该参数即返回JSON格式（也可以用请求头 Accpet: application/json 表示），默认重定向到图片地址
• d: 日期：格式为YYYYMMDD，如20250606，默认当天，支持特殊值：random随机返回某天数据

      请求示例: 

• https://hub.saintic.com/openservice/bingpic
• https://hub.saintic.com/openservice/bingpic?d=20250606
• <img src='https://hub.saintic.com/openservice/bingpic?p=4k' />
• <img src='https://hub.saintic.com/openservice/bingpic?mobile' />

响应： 
      响应参数: 

• json: 返回JSON，如下示例，success为true表示获取成功
• str: 重定向至今日美图地址

      响应示例: 

• {"data": {"copyright": "\u8bfa\u66fc\u5e95\u7684\u963f\u7f57\u8292\u4ec0\u83b1\u73ed , \u6cd5\u56fd (\u00a9 Horia Merla/Getty Images)", "date": "20250606", "imgurl": "https://cn.bing.com/th?id=OHR.NormandyBeach_ZH-CN9312381737_1920x1080.jpg", "title": "\u8bfa\u66fc\u5e95\u767b\u9646\u65e5\u7684\u8f6c\u6298\u70b9", "urlbase": "/th?id=OHR.NormandyBeach_ZH-CN9312381737"}, "message": "", "success": true}

# 必应收录查询

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

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

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

• url: 需要查询的地址
• force: Boolean类型（1、true），强制刷新缓存后查询，必会计次！
• method: 查询的方法，可选值rss、html，默认先使用rss查询，失败时再用html查询，建议rss方式，效率更高

      请求示例: 

• # 注意：匿名使用和登录使用有速率限制，请注意查看页头横幅中的公告！
• # 关于登录和接口文档详情请看下方【查看更多】！
• curl -sL https://open.saintic.com/api/BingIncludedQuery/?url=https://www.saintic.com/

响应： 
      响应参数: 

• url: 返回解析后查询地址
• msg: 响应信息
• deduct: 是否计次
• success: 表示请求是否成功（无异常、无请求参数错误等），与 Included 无直接关系
• Included: Boolean类型，表示是否收录, true:收录, false:未收录

      响应示例: 

• {"Included": true, "deduct": true, "msg": null, "success": true, "url": "https://www.saintic.com/"}

更多详情请查看文档

# 百度收录查询

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

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

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

• url: 需要查询的地址
• force: Boolean类型（1、true），强制刷新缓存后查询，必会计次！
• method: 查询的方法，可选值json、html，默认先后使用json和html共同查询

      请求示例: 

• # 注意：匿名使用和登录使用有速率限制，请注意查看页头横幅中的公告！
• # 关于登录和接口文档详情请看下方【查看更多】！
• curl -sL https://open.saintic.com/api/BaiduIncludedQuery/?url=https://www.saintic.com/

响应： 
      响应参数: 

• url: 返回解析后查询地址
• msg: 响应信息
• deduct: 是否计次
• success: 表示请求是否成功（无异常、无请求参数错误等），与 Included 无直接关系
• Included: Boolean类型，表示是否收录, true:收录, false:未收录

      响应示例: 

• {"Included": true, "deduct": true, "msg": null, "success": true, "url": "https://www.saintic.com/"}

更多详情请查看文档

# IP查询接口

描述：  查询IP信息及提供RESTApi服务
优势： 

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

请求： 
      请求地址: https://hub.saintic.com/openservice/ip/rest
      请求方法: GET
      请求参数: 

• ip: 默认为访问者IP，可通过此参数设置为其他值。

      请求示例: 

• curl https://hub.saintic.com/openservice/ip/rest
• rest可以用快捷跳转: curl -L satic.cn/iprest
• rest同级实际上还有其他接口
• /myip 仅查询访问者IP，快捷跳转: curl -L satic.cn/myip
• /addr 查询访问者IP及信息，快捷跳转: curl -L satic.cn/ipinfo

响应： 
      响应参数: 

• 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": "", "success": true}

# 定时任务查询

描述： 查询上下几次运行时间或创建以来运行次数
优势： 

• 支持跨域
• 支持 Linux crontab 时间表达式
• 采用安全可靠的https协议

请求： 
      请求地址: https://hub.saintic.com/openservice/crontab
      请求方法: GET
      请求参数: 

• query_times: int类型，代表查询以后或之前几次运行的时间（最大32），默认值1
• query_type: str类型，代表查询类型，next:之后 prev:之前，分水岭当前时间，默认值next
• format_time: str类型，代表返回时间的格式化字符串，默认值%Y-%m-%d %H:%M:%S
• expression: str类型，公共参数，定时任务时间表达式

      请求示例: 

• curl -sL 'https://hub.saintic.com/openservice/crontab?expression=00+04+*%2f30+*+*&query_times=2&query_type=prev'

响应： 
      响应参数: 

• message: 响应信息
• data: 返回list列表，代表上下几次运行的时间
• success: 返回bool类型，true:请求正确并返回, false:请求发生异常、异常信息见message

      响应示例: 

• {"data": ["2025-07-01 04:00:00", "2025-06-01 04:00:00"], "message": 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/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 -XPOST --cookie sessionId=上述接口返回的Token值 https://open.saintic.com/openservice/shorturl/v1/?Action=shorten -d long_url=https://open.saintic.com -d jid=自定义URL
• 或者将token放入请求头，即 Authorization: Token <Your yoken>
• curl -XPOST -H 'Authorization: Token xxx' https://open.saintic.com/openservice/shorturl/v1/?Action=shorten -d long_url=https://open.saintic.com

响应： 
      响应参数: 

• msg: 失败时的错误信息
• code: 0是请求成功，其他请求失败
• data: 字典，包含short_url为短网址，shorten为唯一标识码

      响应示例: 

• {"code": 0, "data": {"short_url": "https://xxx/6", "shorten": "6"}, "msg": null}

更多详情请查看文档