为了方便各类开发者，现提供免费开放Api接口，所有接口均无使用限制，返回格式全是JSON，所以基本能满足大家的开发需求，但请各位不要将这些Api接入正式项目，因为有一些不稳定因素，目前服务器购买时长是三年，如果到期，我会自动续费，这些Api是我平时业余时间编写，可能有些不能满足需求的情况，请大家在留言区提出来，或者大家写Demo需要一些有关联的数据等等，都可以在留言区告诉我，我有时间一定会给大家处理。

api.apiopen.top

json.apiopen.top


目前接口列表：
新实时段子
https://api.apiopen.top/getJoke?page=1&count=2&type=video
通过Id查段子
https://api.apiopen.top/getSingleJoke?sid=28654780
快递查询：
https://api.apiopen.top/EmailSearch?number=1012002
随机单句诗词推荐：
https://api.apiopen.top/singlePoetry
随机一首诗词推荐：
https://api.apiopen.top/recommendPoetry
搜索古诗词：
https://api.apiopen.top/searchPoetry?name=古风二首%20二
搜索古诗词作者：
https://api.apiopen.top/searchAuthors?name=李白
模糊搜索古诗词（可搜索诗词名、诗词内容、诗词作者）：
https://api.apiopen.top/likePoetry?name=李白
获取宋朝古诗词：
https://api.apiopen.top/getSongPoetry?page=1&count=20
获取唐朝古诗词：
https://api.apiopen.top/getTangPoetry?page=1&count=20
音乐搜索接口：
https://api.apiopen.top/searchMusic?name=不要说话
音乐电台接口：
https://api.apiopen.top/musicBroadcasting
音乐电台详情接口：
https://api.apiopen.top/musicBroadcastingDetails?channelname=public_tuijian_spring
音乐详情接口：
https://api.apiopen.top/musicDetails?id=604392760
音乐排行榜接口：
https://api.apiopen.top/musicRankings
音乐排行榜详情接口：
https://api.apiopen.top/musicRankingsDetails?type=1
每日视频推荐接口：
https://api.apiopen.top/todayVideo
视频大纲获取接口：
https://api.apiopen.top/videoHomeTab
视频分类推荐接口：
https://api.apiopen.top/videoCategory
视频分类推荐接口：
https://api.apiopen.top/videoCategoryDetails?id=14
根据ID推荐接口：
https://api.apiopen.top/videoRecommend?id=127398
新闻接口：
https://www.apiopen.top/journalismApi
随机推荐热门段子（包含文字、图片、GIF、视频）：
https://www.apiopen.top/satinApi?type=1&page=1
随机推荐热门段子【神评版本】（包含文字、图片、GIF、视频）：
https://www.apiopen.top/satinGodApi?type=1&page=1
随机推荐热门段子【神评版本】评论列表：
https://www.apiopen.top/satinCommentApi?id=27610708&page=1
热门小说推荐列表
https://www.apiopen.top/novelApi
小说搜索接口
https://www.apiopen.top/novelSearchApi?name=盗墓笔记
小说详情接口
https://www.apiopen.top/novelInfoApi?name=盗墓笔记
天气获取接口
https://www.apiopen.top/weatherApi?city=成都
美图获取接口
https://www.apiopen.top/meituApi?page=1
个性网名获取接口
https://www.apiopen.top/femaleNameApi?page=1
创建应用接口
https://www.apiopen.top/createUserKey?appId=com.chat.peakchao&passwd=123456
增加统计信息接口
https://www.apiopen.top/addStatistics?appKey=00d91e8e0cca2b76f515926a36db68f5&type=点击统计&typeId=1&count=2
查询统计信息接口
https://www.apiopen.top/findStatistics?appKey=00d91e8e0cca2b76f515926a36db68f5
用户注册接口
https://www.apiopen.top/createUser?key=00d91e8e0cca2b76f515926a36db68f5&phone=13594347817&passwd=123654
用户登陆接口
https://www.apiopen.top/login?key=00d91e8e0cca2b76f515926a36db68f5&phone=13594347817&passwd=123456
由于数据来源于网络，如有侵权，请告知，我将立即删除。
还没写完，现在赶项目，有时间了继续完善。

  
阅读本文大概需要 5~6 分钟


大家可能最近经常听到 API 这个概念，那什么是API，它又有什么特点和好处呢？

wiki 百科镇楼


  
…[APIs are] a set of subroutine definitions, protocols, and tools for building application software. In general terms, it’s a set of clearly defined methods of communication between various software components.


翻译：API 是用于构建应用程序软件的一组子程序定义，协议和工具。一般来说，这是一套明确定义的各种软件组件之间的通信方法。（回来再看(。・∀・)ノ）。

本篇文章中，我会用浅显的比喻来解释API，接口（interface），协议（protocol）这些基本概念。enjoy it !　



假设你有一个银行



 

你有一个仓库来存钱，一个记账本来记各种业务。一个简单的管理银行的方法是直接将权限给所有人，让客户自己动手完成各种业务。

这种模式下，一个客户想要存钱的话，他需要：


拿着钱去银行
打开仓库把钱放进去
把这笔业务写到记帐本上
离开银行


显然这存在着问题：


想开开仓库门需要废很大力气，并不是所有的人都能打开，还有些人不识字不会记账。
在这个模式下，我们假定所有人都是诚实的，显然这并不成立。（说不定哪一个人存了100块钱记账的时候写了10000块）。


这时你遇到麻烦了。



雇一个柜员



要是我们雇一个体格棒，办事还麻利的人来处理开仓库，记账的问题呢？ 

小娜登场了。

现在模式为：建一个柜台将仓库和记账本和顾客分开，这样顾客就不需要再去管仓库和记账本了。想存钱的话直接找小娜就行。



这种模式下，要是有人想存钱，他们必须：


拿钱去银行
告诉小娜我是 MMM 我想要存￥￥￥。
小娜打开仓库把钱放进去
小娜把业务（transaction ）记录好
告诉你业务办好了
顾客离开银行


现在不会发生打不开仓库门或者是记错账的情况了，你觉得很满意。

到此我们引出今天的主角API（ Application Programming Interface），它能够帮你实现轻松的和其他软件组件（如服务器，操作系统等）的交互。

在上面举的例子中，我们雇一个收纳员帮顾客解决了开仓门，放钱，记账这一系列繁琐的过程。这大大节省了顾客的时间，同时提高了银行的效率。同理，如果我们将操作的具体实施步骤抽象化，这将会大大降低开发人员的负担（去记忆所有的步骤花费的力气），从而大大提高了效率。

另外的好处是，只要他们遵循了同一个协议，组件可以交换或者是改变。银行不需要知道时哪一个顾客或者说顾客是怎么进来的，顾客也不需要知道银行拿自己的钱去做什么了。只要负责的柜员在这里并做好工作，整个流程将会继续工作。

API 应用范围很广：从操作系统中简单的 fork()  到我们接触的百度地图API，和风天气API，又或者是邢远分享的段子，这些 API 都大大简化了程序员的工作。



银行里有什么





你可能已经注意到了银行分成了两个区域：顾客在前台排好队来办理业务，后台完成各种对钱的操作。在中间层，前台和后台发生了交互，  双方都不能越界  ，交互只能发生在中间的区域。

在 API 术语里面，我们管中间的这块区域叫做接口 Interface ；在这里各个部分发生交互。在我们的银行中，前台和后台都同意并且规定使用 Interface 来交换信息。

现在，我们假定 Bob 想要取钱。他到了柜台找到了小娜，小娜知道该怎样去取钱，她取好了之后告诉了 Bob。



Bob 这时候又问：“你知道今天的股票行情吗”

小娜：？？？？WTF ?

在这个例子里面，小娜知道怎样取钱和存钱 , 但是她不知道如何去给Bob查查今天的股票行情是怎样的。这个例子引出了另一个概念 协议（Protocol）。

在 API 术语中，协议 是规定了各部分之间如何进行交流的一系列规则的集合。各部分之间想要完成交互必须理解并且遵守同一个协议。

同时，我们注意到了交换时用的是中文。如果Bob 对小娜说「我想撳五百蚊出嚟呀唔該」，小娜不懂广东话，所以没法理解Bob说的是什么，这又引出了另一个概念 格式（Format）

在程序员的世界里，通用的格式包含 XML   和   JSON。

最后，让我们假设银行想要扩展业务到股市，这时候就需要一位特殊的接待员来处理与股票相关的业务了，这时，小冰就登场啦。 



在 API 术语里面， API 端点 通常是指在同一个接口中提供特定功能子集的服务提供者。在这种情况下，小冰和小娜都是端点。（小冰和小娜是同一个柜台不同功能的提供者）不同的端点可以有不同的协议和不同的格式。

总结起来：接口是不同组件进行交互的地方。协议是一系列规定了他们之间怎样进行交互的规则。格式定义了他们通过什么进行交流（JSON或者是XML），端点可以在同一个接口里面提供不同的功能。



柜员还能干什么？



到现在我们把 API 的基础知识过了一遍，接下来我们再来谈一谈 API　的其他特征。w(ﾟДﾟ)w

现在又有客户来取钱了，他想要取￥10000。 



首先，我们可以指示小娜在操作前先去确认一下 Bob 是否真的有这么多钱。（API 能确认所有的操作都是合法的。）

小娜查到 Bob 账户里只有一百块了，告诉 Bob 余额不足。（在发生错误的时候 API 会根据错误报告机制发出指示，减轻开发人员的负担。）

Bob 认为肯定是哪里出错了，他要求银行给他列一张表，给出他所拥有的每个账户上的余额。结果显示一共有 200 个账户。把他们一下子全给列出来不太实际，所以小娜每次给 Bob 看十个账户，看完了之后再来十个。（这叫做分页（pagination），可以节省带宽和服务器资源，因为你不需要一次获取数据集中的所有内容。）

如果 Bob 只想要知道他某一个账户中的余额的话，他可以要求小娜只给她看那个的（这称为过滤（filtering），它还有助于节省带宽和资源，并且更易于导航。）

在检查完所有账户之后，鲍勃现在知道他的帐户中确实没有10000美元。他知道爱丽丝购买股票并获得了大量资金，于是伪装成爱丽丝并重新进入银行。他告诉莎莉：“我是爱丽丝，我想从我的账户中提取10000美元。” 小娜识破了他的骗局。（API中内置授权和访问控制，以确保只有授权人员才能访问特定数据。）

最后，在试图从银行拿到10000美元失败后，他想报复小娜，他进入银行并多次从账户中提取0.01美元。 （我们可以实施速率限制来控制服务器资源的使用，以确保用户不会滥用服务。）

API 通常都会被设计具有这些功能，它可以充当防火墙，在保护您的资源免受滥用的同时允许合法请求通过。



再读Wiki




  
…[APIs are] a set of subroutine definitions, protocols, and tools for building application software. In general terms, it’s a set of clearly defined methods of communication between various software components.


API 是用于构建应用程序软件的一组子程序定义，协议和工具。一般来说，这是一套明确定义的各种软件组件之间的通信方法。

现在是不是头脑里对这个概念清晰多了呢。

一：.NET Core 使用IdentityServer4保护API
1：首先添加nuget包：Microsoft.AspNetCore.Authentication.JwtBearer

2：在Startup.cs类ConfigureServices方法中，将身份验证服务添加到DI并配置Bearer为默认方案
public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();

    //将身份验证服务添加到DI并配置Bearer为默认方案。
    services.AddAuthentication("Bearer")
        .AddJwtBearer("Bearer", options =>
        {
        	//地址为id4认证中心地址
            options.Authority = "http://localhost:5000";
            options.RequireHttpsMetadata = false;
            options.Audience = "api1";
        });
}

3:在Configure方法中，将身份验证中间件添加到管道中，以便对主机的每次调用都将自动执行身份验证
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.UseRouting();

    //将身份验证中间件添加到管道中，以便对主机的每次调用都将自动执行身份验证。
    app.UseAuthentication();
    //授权中间件，以确保匿名客户端无法访问我们的API端点。
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

4:在需要被保护的API控制器上添加[Authorize]特性
二：客户端在请求对应API之前需要向IdentityServer4获取access_token（获取token地址）
然后拿着获取到的access_token去访问api，只需要在请求头Headers中添加参数：Authorization，值为：Bearer+空格+access_token，可以看到已经能成功访问到被保护的API了

一：Client Credentials介绍
Client Credentials：客户端凭证模式；该方法通常用于服务器之间的通讯；该模式仅发生在Client与Identity Server之间。

该模式的适用场景为服务器与服务器之间的通信

1：添加nuget包：IdentityModel

2：使用如下代码访问api
using System;
using System.Net.Http;
using System.Threading.Tasks;

using IdentityModel.Client;

using Newtonsoft.Json.Linq;

namespace ClientCredentialsConsoleApp
{
    class Program
    {
        static async Task Main(string[] args)
        {
            //discovery endpoint - 发现终结点
            HttpClient client = new HttpClient();
            DiscoveryDocumentResponse disco =
                await client.GetDiscoveryDocumentAsync("http://localhost:5000");
            if (disco.IsError)
            {
                Console.WriteLine($"[DiscoveryDocumentResponse Error]: {disco.Error}");
                return;
            }

            //request access token - 请求访问令牌
            TokenResponse tokenResponse = await client.RequestClientCredentialsTokenAsync(
                new ClientCredentialsTokenRequest
                {
                    Address = disco.TokenEndpoint,
                    ClientId = "client",
                    ClientSecret = "secret",
                    Scope = "api1"
                });
            if (tokenResponse.IsError)
            {
                Console.WriteLine($"[TokenResponse Error]: {tokenResponse.Error}");
                return;
            }
            else
            {
                Console.WriteLine($"Access Token: {tokenResponse.AccessToken}");
            }

            //call API Resource - 访问API资源
            HttpClient apiClient = new HttpClient();
            apiClient.SetBearerToken(tokenResponse.AccessToken);
            HttpResponseMessage response = await apiClient.GetAsync("http://localhost:6000/weatherforecast");
            if (!response.IsSuccessStatusCode)
            {
                Console.WriteLine($"API Request Error, StatusCode is : {response.StatusCode}");
            }
            else
            {
                string content = await response.Content.ReadAsStringAsync();
                Console.WriteLine(JArray.Parse(content));
            }

            Console.ReadKey();
        }
    }
}