OpenAPI

诏预开放平台 对外开放的接口，以下接口基于域名 https://open.saintic.com 提供服务（节选部分需要提供详细说明的接口）。

Pay

部分开放的接口匿名、登录用户均有一定的免费额度，对个人一般场景也足够使用， 不过针对高频用户可能需要提升额度，故也提供付费升级。

鉴于实际情况，个人暂时无法提供企业级在线收付款接口，故此如有需求请通过微信、支付宝等方式 转账或发送红包。

联系方式：

  • 邮箱：me@tcw.im

  • 微信/QQ：1663116375

  • “ 请添加 saintic、开放平台、付费 等备注字样之一 ”

支付方式：

  • 支付宝口令红包

  • 支付宝转账：me@tcw.im

  • 微信/QQ转账：1663116375

支付说明：

根据不同模块、不同规格需要付费金额亦不相同，按模块计费，内部接口共享额度， 具体规则参考模块内付费规则。

支付后请联系并提供自己的 UID （登录：开放平台-控制台 查看我的信息） 和支付凭证，如有特别说明请一并留言。

服务条款：

  • 由于个人维护，不保证 7*24 服务在线，但故障会及时处理。

  • 拒绝为黄赌毒及涉嫌违规违法网站使用，一经发现会立即禁用服务，且不予退款！

  • 请求速率限制后大量或短时间内大量请求会被认为DDOS从而短暂或永久封禁来源IP。

  • 如不同意本条款请停止使用，如继续使用则视为同意；本条款适时修改，即时生效。

接口认证：

  1. 登录：开放平台-控制台

  2. 创建：定位到 我的API密钥 点击创建，根据实际选择权限，立即提交。

  3. 复制：在 我的API密钥 列表可以点击密钥即可复制内容。

  4. 使用：有三种使用方式

  • url query

直接附加到URL查询参数中，不需要额外构建请求头，方便快捷但不安全，适用于GET/POST请求。

格式：token=对密钥原文进行URL安全的base64编码后的加密串

  • post form

放到请求主体中，适用于POST请求，方便快捷安全。

格式：token=密钥原文

  • header token

放到请求头中，适用于GET/POST请求。

格式：Authorization=Token 密钥原文

SEC

此模块名为 Search Engine Collector，即搜索引擎收录查询器，简写为 SEC ， 目前包括百度、必应（Bing）收录查询。

搜索引擎有查询验证，故此接口也有速率限制，匿名、登录用户、付费用户有不同速率：

匿名用户： 5/d/ip （每IP每天总共 5 次）；

登录用户： 20/d/user （每用户每天总共 20 次）。

付费用户： 按付费规则

支持 url query 和 header token 两种认证方式，只读密钥权限即可。

付费规则：

SEC相关接口请求成功时都会返回 deduct 字段表示计次： 按次方式消耗的是总次数；包月方式消耗的是每天最大上限。

付费方式：按次、包月

计费规则：按次是一次一分钱，包月则分级给量

规则详情：

  1. 包月方式分级（月按 30 天计算，年按 365 天计算）：

  • 初级档位：￥15/月，最大限制每天 100 次

  • 中级档位：￥30/月，最大限制每天 1000 次

  • 高级档位：￥50/月，最大限制每天 10000 次

  • “ 支持连续包月，比如金额￥30，联系并留言需要2个月，即提供60天服务！ ”

  1. 按次方式：请求限制 每分钟 120 次，按金额（分）等量换算为次数，最大使用时长一年，过期作废。

  2. 命中缓存不计次：查询URL时如果收录会写入缓存，后续查询则直接返回已收录并且不计次。

sec.baidu

GET /api/BaiduIncludedQuery

百度收录查询接口

Query Parameters:

  • url (string) – 要查询的URL地址，要以http或https开头

  • method (string) – 查询的方法，可选值json、html，默认先后使用json和html共同查询

  • force (boolean) – 是否强制刷新缓存后再查询收录状态，此必会计次

Response JSON Object:

  • Included (boolean) – 表示是否收录

  • success (boolean) – 表示请求是否成功、有无异常，与 Included 无直接关系！

  • deduct (boolean) – 表示是否计次

  • url (string) – 返回解析后的查询URL地址

  • msg (string) – 未收录时

Status Codes:

示例1（Header认证）：

http

GET /api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com HTTP/1.0
Host: open.saintic.com
Authorization: Token <API-Key>

curl

curl -i -X GET 'https://open.saintic.com/api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com' -H "Authorization: Token <API-Key>"

python-requests

requests.get('https://open.saintic.com/api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com', headers={'Authorization': 'Token <API-Key>'})

response

HTTP/1.0 200 OK
Content-Type: application/json

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

示例2（URL Query认证）：

http

GET /api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY HTTP/1.0
Host: open.saintic.com

curl

curl -i -X GET 'https://open.saintic.com/api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY'

python-requests

requests.get('https://open.saintic.com/api/BaiduIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY')

response

HTTP/1.0 200 OK
Content-Type: application/json

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

sec.bing

GET /api/BingIncludedQuery

必应（Bing）收录查询接口

Query Parameters:

  • url (string) – 要查询的URL地址，要以http或https开头

  • method (string) – 查询的方法，可选值rss、html，默认先后使用rss和html共同查询

  • force (boolean) – 是否强制刷新缓存后再查询收录状态，此必会计次

Response JSON Object:

  • Included (boolean) – 表示是否收录

  • success (boolean) – 表示请求是否成功、有无异常，与 Included 无直接关系！

  • deduct (boolean) – 表示是否计次

  • url (string) – 返回解析后的查询URL地址

  • msg (string) – 未收录时

Status Codes:

示例1（Header认证）：

http

GET /api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com HTTP/1.0
Host: open.saintic.com
Authorization: Token <API-Key>

curl

curl -i -X GET 'https://open.saintic.com/api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com' -H "Authorization: Token <API-Key>"

python-requests

requests.get('https://open.saintic.com/api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com', headers={'Authorization': 'Token <API-Key>'})

response

HTTP/1.0 200 OK
Content-Type: application/json

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

示例2（URL Query认证）：

http

GET /api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY HTTP/1.0
Host: open.saintic.com

curl

curl -i -X GET 'https://open.saintic.com/api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY'

python-requests

requests.get('https://open.saintic.com/api/BingIncludedQuery?url=https%3A%2F%2Fwww.saintic.com&token=urlsafe_base64_encode_API-KEY')

response

HTTP/1.0 200 OK
Content-Type: application/json

{
    "Included": true,
    "success": true,
    "deduct": true,
    "msg": null,
    "url": "https://www.saintic.com/"
}
← 花瓣、堆糖远程下载接口说明 花瓣、堆糖网下载 →