本站API帮助文档

admin 215 0

URL:http://api.xyde.net.cn

该站点提供各类API,API列表如下:

  • 图像识别OCR(不开放)

  • QQ绑定查询(不开放)

  • 手机号绑定查询(不开放)

  • 每日Bing美图(开放)

  • 二维码生成(开放)

  • 短视频解析(开放)

  • 星座运势分析(开放)

  • 中原工学院官网信息(开放)

  • 发送邮件(开放)

  • 发送短信(测试)

  • 贴吧爬虫(开放)

  • QQ授权登录(开放)

  • 微信授权登录(开放)


1.每日Bing美图

URL:http://api.xyde.net.cn/bing

访问方式:GET

Content-Type: image/jpeg;text/html;

允许跨域:否


详解:返回每日Bing图片,一天一换。


2.二维码生成

URL:http://api.xyde.net.cn/qr

访问方式:GET

访问参数:content

访问示例:http://api.xyde.net.cn/qr?content=12345

Content-Type: image/jpeg;text/html

允许跨域:否


详解:返回指定内容对应的二维码图片。


3.短视频解析

URL:http://api.xyde.net.cn/s_video

访问方式:GET

访问参数:url

访问示例:http://api.xyde.net.cn/s_video?url=http://v.douyin.com/xxxx

Content-Type:application/json

允许跨域:是


详解:url参数为抖音、快手等短视频分享的网址,解析出来无水印的视频下载地址,以json形式返回。

4.星座运势分析

URL:http://api.xyde.net.cn/xingzuo

访问方式:GET

参数:type(必选)、json(可选)、timetype(可选)

参数 type 为星座英文名,一般为:

魔羯座 (12/22 - 01/19) Capricorn
水瓶座 (01/ 20- 02/18) Aquarius
双鱼座 (02/19- 03/20) Pisces
白羊座 (03/21 - 04/20) Aries
金牛座 (04/21 - 05/20) Taurus
双子座 (05/21 - 6/21) Gemini
巨蟹座 (06/22- 07/22 Cancer
狮子座 (07/23 - 08/22) Leo
处女座 (08/23 - 09/22) Virgo
天秤座 (09/23 - 10/23) Libra
天蝎座 (10/24 - 11/21) Scorpio
射手座 (11/22 - 12/21) Sagittarius

参数 json 为布尔型,是否以json格式返回信息。若为true,则返回json,默认返回文本。

参数 timetype 可选:day、week、month、year,分别是查看本日、本周、本月、本年的星座运势。

请求示例:http://api.xyde.net.cn/xingzuo?type=aries&timetype=year&json=true

Content-Type:application/json

允许跨域:是


详解:该接口由紫微星座网、中华万年历抓取提供。


5.中原工学院官网信息

URL:http://api.xyde.net.cn/zut

该接口分为新闻、公告两部分。

获取新闻:http://api.xyde.net.cn/zut/news

获取公告:http://api.xyde.net.cn/zut/notice

访问方式:GET

访问参数:page(可选)

参数 page 为整数,默认为首页(page是最后一页)

Content-Type:application/json

访问示例:http://api.xyde.net.cn/zut/notice?page=2

允许跨域:是


详解:实时抓取中原工学院官网信息,以json格式返回,方便后端调用查阅。


6.发送邮件

URL:http://api.xyde.net.cn/mail

访问方式:GET / POST

访问参数:to(必选)、sender(可选)、title(可选)、content(必选)

参数 to 为接收者邮箱;sender 为发送者的昵称;title 为发送邮件的标题;content 为发送邮件的内容(支持HTML格式,以<br>为换行符)。

Content-Type:application/json

访问示例:

GET:http://api.xyde.net.cn/mail?to=10000@qq.com&sender=测试者&title=客户关怀邮件&content=你好


POST(推荐):访问采用表单提交标准,前端JS可采用FormData完成。

function sendMail($sender = "发送者",$to,$title = "无标题",$content = "默认内容"){
    $data = ['to'=>$to,'sender'=>$sender,'title'=>$title,'content'=>$content];
$headers = array('Content-Type: application/x-www-form-urlencoded');
$curl = curl_init(); // 启动一个CURL会话
curl_setopt($curl, CURLOPT_URL, 'http://api.xyde.net.cn/mail/'); // 要访问的地址
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); // 对认证证书来源的检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); // 模拟用户使用的浏览器
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1); // 使用自动跳转
curl_setopt($curl, CURLOPT_AUTOREFERER, 1); // 自动设置Referer
curl_setopt($curl, CURLOPT_POST, 1); // 发送一个常规的Post请求
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data)); // Post提交的数据包
curl_setopt($curl, CURLOPT_TIMEOUT, 30); // 设置超时限制防止死循环
curl_setopt($curl, CURLOPT_HEADER, 0); // 显示返回的Header区域内容
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // 获取的信息以文件流的形式返回
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($curl); // 执行操作
if (curl_errno($curl)) {
    echo 'Errno'.curl_error($curl);//捕抓异常
}
curl_close($curl); // 关闭CURL会话
echo('[任务结果]发送至'.$to.'完毕,结果:'.$result.PHP_EOL);
}

PHP代码

允许跨域:是


详解:发送邮件,结果或发送是否成功以返回的json信息为准。发送成功返回code为0,其余皆为发送失败,并在json返回的msg中有失败原因;不建议发送长信息,可能会导致失败。


7.百度贴吧爬虫

URL:http://api.xyde.net.cn/tieba

访问方式:GET

访问参数:subject(可选)、page(可选)

参数 subject 为 贴吧名称;page 为 贴吧页码‘

Content-Type:application/json

访问示例:http://api.xyde.net.cn/tieba?subject=中国&page=1

允许跨域:是


详解:实时抓取贴吧帖子,以热度逆序排序后返回。


8.QQ授权登录

URL:http://api.xyde.net.cn/auth/qq/

访问方式:GET & POST

Content-Type:application/json


该API分为两步,首先通过GET请求 api.xyde.net.cn/auth/qq ,然后获取到如下格式的JSON

本站API帮助文档-第1张图片-极光之门

code : 返回 1 代表获取二维码成功;

qrsig : 该图片的签名,请求验证结果时需要用到;

data : 二维码的Base64编码,加入 data:image/png;base64, 后通过Base64编码转换为图片即可使用;


POST请求后,再次请求api网址,采用表单类型传值(xxx-www-form-urlencoded),将qrsig(二维码签名)传到请求体里,即可获取到登录基础信息;

以下是成功信息:

uin QQ号

nick QQ昵称

skey 登录后的Skey

superkey、pskey同理

msg 返回消息


另外,为方便获取用户QQ头像,我也编写了API:http://api.xyde.net.cn/auth/qq/avater.php?qq=10000

即可获取对应QQ用户的头像,如上一行API获取了QQ号为10000的用户头像。

该API返回img图片,不是base64编码,直接在img标签中引用地址即可显示。


code 响应说明

code描述
2正在验证二维码,即手机QQ已扫码等待确认
1QQ登录成功
0请使用手机QQ扫码登录,即二维码未过期,等待扫码
-1参数错误,可能是部分必要参数为空
-2请求已过过期
-3签名不正确
-4登录二维码已失效
-5未知错误001
-6未知错误002


另外,我还写了个QQ扫码登录的demo,大家可以体验一下:http://api.xyde.net.cn/auth/qq/demo.html


9.微信授权登录

URL:http://api.xyde.net.cn/auth/wechat/

注意:该方式由Web微信协议解析而来,部分微信无法使用该方式登录,且登录后只能获取到该微信的匿名ID信息,建议使用QQ授权登录

访问方式:GET

Content-Type:application/json


第一步访问该URL,获取二维码的Base64信息和uuid(二维码唯一标识),后续使用该uuid判断登录;code 200 代表请求成功。

本站API帮助文档-第2张图片-极光之门

之后GET网址,加入uuid参数,即可获取到扫码该二维码的结果:

本站API帮助文档-第3张图片-极光之门

其中,code 为扫描二维码的状态码;

uin 为 该 微信的 唯一匿名标识,目前已知该微信使用TIM登录时,会使用QQ号为uin的账号登录;

type 则 固定为 wx;

msg 代表扫描状态,一般是code对应的解释。


code 响应说明

code描述
200微信登录成功
400短时间连续扫码,登录失败
408等待用户扫描
-1二维码已经失效

10.发送短信(测试)

URL:http://api.xyde.net.cn/sms/

注意:该API仅对部分开发者开放,需联系博主获取授权key方可使用。

且本API仅支持短信验证码,不支持自定义内容

短信单价:0.2元/条

Content-Type:application/json

请求方式:GET & POST

请求参数:key、content、mobile

GET方式直接请求,POST方式请以表单形式提交!

其中,key为博主授权后的key,content是短信内容,mobile是手机号码。

content支持格式:【51酷玩】您的验证码为{code},在{time}分钟内有效。

请求示例:http://api.xyde.net.cn/sms/?key=12345&content=【51酷玩】您的验证码是2345,在5分钟内有效。&mobile=17666540001


标签: 后端 前端 api

发表评论 (已有0条评论)

还木有评论哦,快来抢沙发吧~