饥人谷开放 API
所有接口如想使用 https 协议,可把对于后缀是.php 的接口可把 http://api.jirengu.com 替换成 https://jirenguapi.applinzi.com
说明
以下API仅供学习交流使用,严谨用于商业用途。
API来源包括百度天气API、豆瓣FMAPI、GitHub API。
FM API v2
FM API数据源来自豆瓣 FM,仅供前端爱好者学习交流使用。如冒昧侵权,请联系我们删除 邮箱
获取专辑分类
接口: http://api.jirengu.com/fm/v2/getChannels.php
请求类型: GET
请求参数:
无
支持cors, 支持jsonp
使用范例:
范例1
http://api.jirengu.com/fm/v2/getChannels.php
http://api.jirengu.com/fm/v2/getChannels.php?callback=getChannel
范例2
$.get('http://api.jirengu.com/fm/v2/getChannels.php')
.done(function(channelInfo){
console.log(channelInfo)
});
获取随机歌曲
接口: http://api.jirengu.com/fm/v2/getSong.php
请求类型: GET
请求参数:
channel: channel的ID(不填为默认)
支持cors, 支持jsonp
使用范例:
范例1
http://api.jirengu.com/fm/v2/getSong.php?channel=4
http://api.jirengu.com/fm/v2/getSong.php?channel=4&callback=getSong
//https协议,可以在 github pages 上使用
https://jirenguapi.applinzi.com/fm/v2/getSong.php?channel=4
范例2
$.get('http://api.jirengu.com/fm/v2/getSong.php',{channel: 'public_aaa_bbb'})
.done(function(song){
console.log(song)
});
获取歌词
该接口可不用,获取歌曲信息中已包含歌词链接
接口: http://api.jirengu.com/fm/v2/getLyric.php或者 https://jirenguapi.applinzi.com/fm/v2/getLyric.php
请求类型: POST,GET均可
请求参数:
sid: 歌曲id
ssid: 歌曲ssid
支持cors,jsonp
使用范例:
范例
http://jirenguapi.applinzi.com/fm/v2/getLyric.php?&sid=1451876&ssid=0ea3
https://jirenguapi.applinzi.com/fm/v2/getLyric.php?&sid=1451876&ssid=0ea3
http://jirenguapi.applinzi.com/fm/v2/getLyric.php?sid=1451876&ssid=0ea3&callback=getLyric
$.post('http://api.jirengu.com/fm/getLyric.php',{sid:"758918", ssid:"0ea3"})
.done(function(lyric){
console.log(lyric)
});
天气API
老接口不需要 key
获取当前用户城市
接口: http://api.jirengu.com/city.php
请求类型: GET
请求参数:
无
支持cors, 支持jsonp
使用范例:
范例1
http://api.jirengu.com/city.php
http://api.jirengu.com/city.php?callback=getCity
获取天气简略接口
接口: http://api.jirengu.com/getWeather.php
请求类型: GET
请求参数:
city: 城市名; 此参数为空获取的是当前用户所在城市的天气
支持cors, 支持jsonp
使用范例:
范例1
http://api.jirengu.com/getWeather.php
http://api.jirengu.com/getWeather.php?callback=getWeather
范例2
http://api.jirengu.com/getWeather.php?city=北京
把线上 markdown 地址转化成在线 PPT
GitHub API
使用说明
作用:
拉取github项目地址中的readme.md,解析成html
接口: http://api.jirengu.com/readme2html.php
请求类型: GET
请求参数:
url: github项目地址
支持跨域
使用范例:
范例1
http://api.jirengu.com/readme2html.php?url=https://github.com/jirengu/server-mock
范例2
$.get('http://api.jirengu.com/readme2html.php',{
url:'https://github.com/jirengu/server-mock'
}).done(function(tpl){
$('body').append(tpl)
//$('pre code').each(function(i, block) {
// hljs.highlightBlock(block);
//});
});
markdown API
使用说明
作用:
传入markdown文件的线上地址,解析成html
接口: http://api.jirengu.com/md2html.php
请求类型: GET
请求参数:
url: markdwon文件线上地址
支持跨域
使用范例:
范例1
http://api.jirengu.com/md2html.php?url=https://raw.githubusercontent.com/jirengu/server-mock/master/README.md
范例2
$.get('http://api.jirengu.com/md2html.php',{
url:'https://raw.githubusercontent.com/jirengu/server-mock/master/README.md'
}).done(function(tpl){
$('body').append(tpl)
$('pre code').each(function(i, block) {
hljs.highlightBlock(block);
});
});
markdown page API
使用说明
作用:
传入markdown文件的线上地址,解析并展示成页面,添加样式
接口: http://api.jirengu.com/md2page.php
请求类型: GET
请求参数:
url: markdwon文件线上地址
支持跨域
使用范例:
范例1
http://api.jirengu.com/md2page.php?url=https://raw.githubusercontent.com/jirengu/server-mock/master/README.md