錄：

1，Spring Boot集成Swagger

2，Swagger接口文檔頁面

3，常見問題和解決方法

在Sping開發(fā)REST接口服務(wù)時(shí)，API文檔是不可缺少的一個(gè)重要部分。Swagger框架定義了完整的REST接口文檔規(guī)范，提供了強(qiáng)大的頁面測試功能，能夠調(diào)試和可視化API接口服務(wù)，并且將文檔融合到代碼中，讓維護(hù)文檔和修改代碼整合為一體，使得修改代碼邏輯的同時(shí)方便的修改文檔說明。

Spring集成Swagger只需3步配置，就能在線生成接口文檔，調(diào)試API功能。

代碼下載：https://github.com/jextop/StarterApi/

一，Spring Boot集成Swagger

1. 在pom.xml中添加Swagger依賴

2. 添加SwaggerConfig.java，配置文檔信息和掃描包路徑

3. （可選）代碼中引用Swagger注解，增加接口文檔。

- 不添加這些注解時(shí)，Swagger自動生成在線文檔將使用默認(rèn)信息。

- 修改代碼功能邏輯時(shí)，同時(shí)維護(hù)文檔信息。

二，啟動項(xiàng)目，打開文檔頁面

1. http://localhost:8011/swagger-ui.html

2. 展開API信息，點(diǎn)擊按鈕”Try it out!”，調(diào)試接口功能。

三，常見問題和解決方法

l 增加@Api(tags={“xxx中文”})，Swagger文檔頁面中點(diǎn)擊接口名稱無法展開詳情？

解決：在pom.xml中配置maven依賴使用Swagger2.7.0或以后版本

原因：Swagger2.7.0修復(fù)了tags對中文的支持

halApi開源接口框架

讀音：派框架，官網(wǎng)：https://www.phalapi.net/

PhalApi是一個(gè)PHP輕量級開源接口框架，致力于快速開發(fā)接口服務(wù)。支持HTTP/SOAP/RPC等協(xié)議，可用于搭建接口/微服務(wù)/RESTful接口/Web Services。承諾永久免費(fèi)，可用于商業(yè)用途。

它支持自動生成接口文檔、自動進(jìn)行參數(shù)校驗(yàn)、自動生成單元測試代碼、自動擁有CURD數(shù)據(jù)接口、自動安裝程序，讓接口開發(fā)更簡單、更高效、更專業(yè)。

PhalApi官網(wǎng)截圖：

在線示例

使用PhalApi開源接口框架，能快速開發(fā)編寫你的API接口，并能自動生成在線接口文檔。

在線示例：

• 在線接口文檔：http://demo.phalapi.net/docs.php
• 接口詳情文檔（以默認(rèn)接口為例）：http://demo.phalapi.net/docs.php?service=App.Site.Index&detail=1&type=fold
• 默認(rèn)接口服務(wù)：http://demo.phalapi.net/?s=App.Site.Index

PhalApi會根據(jù)你編寫的接口的參數(shù)配置和代碼注釋，自動實(shí)時(shí)生成在線接口文檔。接口列表頁效果類似如下：

PhalApi還支持在線接口測試、請求示例說明、生成離線版HTML接口文檔、實(shí)時(shí)更新。接口文檔詳情頁效果類似如下：

快速安裝

composer一鍵安裝

使用composer創(chuàng)建項(xiàng)目的命令，可實(shí)現(xiàn)一鍵安裝。

$ composer create-project phalapi/phalapi

溫馨提示：關(guān)于composer的使用，請參考Composer 中文網(wǎng) / Packagist 中國全量鏡像。

手動下載安裝

或者，也可以進(jìn)行手動安裝。將此Git項(xiàng)目代碼下載解壓后，進(jìn)行可選的composer更新，即：

$ composer update

部署

Nginx配置

如果使用的是Nginx，可參考以下配置。

server {
    listen 80;
    server_name dev.phalapi.net;
    # 將根目錄設(shè)置到public目錄
    root /path/to/phalapi/public;
    charset utf-8;


    location / {
        index index.php;
    }


    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        # 根據(jù)當(dāng)前環(huán)境，選擇合適的通訊方式
        # fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

配置時(shí)需要將網(wǎng)站根目錄設(shè)置到public目錄，配置保存后重啟nginx。

溫馨提示：推薦將訪問根路徑指向/path/to/phalapi/public。

數(shù)據(jù)庫配置

如何使用的是MySQL數(shù)據(jù)庫，參考修改./config/dbs.php數(shù)據(jù)庫配置。

return array(
    /**
     * DB數(shù)據(jù)庫服務(wù)器集群 / database cluster
     */
    'servers'=> array(
        'db_master'=> array(                       // 服務(wù)器標(biāo)記 / database identify
            'type'=> 'mysql',                 // 數(shù)據(jù)庫類型，暫時(shí)只支持：mysql, sqlserver / database type
            'host'=> '127.0.0.1',             // 數(shù)據(jù)庫域名 / database host
            'name'=> 'phalapi',               // 數(shù)據(jù)庫名字 / database name
            'user'=> 'root',                  // 數(shù)據(jù)庫用戶名 / database user
            'password'=> '',                      // 數(shù)據(jù)庫密碼 / database password
            'port'=> 3306,                    // 數(shù)據(jù)庫端口 / database port
            'charset'=> 'UTF8',                  // 數(shù)據(jù)庫字符集 / database charset
            'pdo_attr_string'=> false,           // 數(shù)據(jù)庫查詢結(jié)果統(tǒng)一使用字符串，true是，false否
            'driver_options'=> array(              // PDO初始化時(shí)的連接選項(xiàng)配置
                // 若需要更多配置，請參考官方文檔：https://www.php.net/manual/zh/pdo.constants.php
            ),
        ),
    ),


    // 更多代碼省略……
);

最后，需要給runtime目錄添加寫入權(quán)限。

運(yùn)行和使用

調(diào)用接口

在PhalApi，你可以通過service參數(shù)（短名字是s參數(shù)）指定需要調(diào)用的接口服務(wù)。例如，訪問默認(rèn)接口服務(wù)。

http://dev.phalapi.net/?s=App.Site.Index

接口請求后結(jié)果輸出類似如下：

{
    "ret": 200,
    "data": {
        "title": "Hello PhalApi",
        "version": "2.4.2",
        "time": 1501079142
    },
    "msg": ""
}

對應(yīng)執(zhí)行的PHP代碼在./src/app/Api/Site.php文件，源碼片段如下：

<?php
namespace App\Api;
use PhalApi\Api;


/**
 * 默認(rèn)接口服務(wù)類
 * @author: dogstar <chanzonghuang@gmail.com> 2014-10-04
 */
class Site extends Api {
    public function getRules() {
        return array(
            'index'=> array(
                'username'=> array('name'=> 'username', 'default'=> 'PhalApi', 'desc'=> '用戶名'),
            ),
        );
    }


    /**
     * 默認(rèn)接口服務(wù)
     * @desc 默認(rèn)接口服務(wù)，當(dāng)未指定接口服務(wù)時(shí)執(zhí)行此接口服務(wù)
     * @return string title 標(biāo)題
     * @return string content 內(nèi)容
     * @return string version 版本，格式：X.X.X
     * @return int time 當(dāng)前時(shí)間戳
     * @exception 400 非法請求，參數(shù)傳遞錯(cuò)誤
     */
    public function index() {
        return array(
            'title'=> 'Hello ' . $this->username,
            'version'=> PHALAPI_VERSION,
            'time'=> $_SERVER['REQUEST_TIME'],
        );
    }
}

運(yùn)行效果，截圖如下：

自動生成的接口文檔詳情頁局部截圖如下：

翻譯

修改./public/init.php文件，可設(shè)置當(dāng)前語言。

// 翻譯語言包設(shè)定-簡體中文
\PhalApi\SL('zh_cn');


// Setting language to English
\PhalApi\SL('en');

一張圖告訴你如何使用PhalApi 2.x

PhalApi開發(fā)文檔

專為PHPer準(zhǔn)備的優(yōu)雅而詳細(xì)的開發(fā)文檔，基本都能在文檔找到你要的答案，請看：PhalApi 2.x 開發(fā)文檔，http://docs.phalapi.net/#/v2.0/。

文檔使用markdown編寫，文檔頁面截圖如下：

開發(fā)文檔大綱：

PhalApi 2.x 開發(fā)文檔


    前言
        前言
        如何升級PhalApi？


    一、快速開發(fā)
        1.1下載與安裝
        1.2 運(yùn)行Hello World
        1.3 如何請求接口服務(wù)
        1.4 接口響應(yīng)與在線調(diào)試
        1.5 Api接口層
        1.6 DataApi通用數(shù)據(jù)接口
        1.7 Domain領(lǐng)域?qū)优cADM模式
        1.8 Model數(shù)據(jù)層與數(shù)據(jù)庫操作
        1.9 DataModel數(shù)據(jù)基類
        1.10 單元測試
        1.11 自動加載和PSR-4
        1.12 接口文檔
        1.13 初始化


    二、數(shù)據(jù)庫
        2.1 數(shù)據(jù)庫連接
        2.2 數(shù)據(jù)庫與NotORM
        2.3 數(shù)據(jù)庫使用和查詢
        2.4 數(shù)據(jù)庫分庫分表策略
        2.5 連接多個(gè)數(shù)據(jù)庫
        2.6 打印和保存SQL語句
        2.7 定制你的Model基類


    三、高級專題
        3.1 接口參數(shù)
        3.2 配置
        3.3 日志
        3.4 緩存
        3.5 過濾器(接口簽名)
        3.6 COOKIE
        3.7 加密
        3.8 國際化
        3.9 CURL請求
        3.10 工具和雜項(xiàng)
        3.11 DI服務(wù)匯總
        3.12 擴(kuò)展類庫
        3.13 SDK包的使用
        3.14 腳本命令
        3.15 MQ隊(duì)列
        3.16 錯(cuò)誤處理

2020視頻教程

B站首發(fā)，第一課~第十一課，配套有每節(jié)課的視頻知識點(diǎn)大綱。

http://docs.phalapi.net/#/v2.0/video_1

視頻課程：

    PhalApi 2020視頻教程
        第一課 B站首發(fā)，2020視頻教程開講啦！
        第二課 視頻教程 - 下載和安裝
        第三課 視頻教程 - Hello World
        第四課 視頻教程 - 如何請求接口服務(wù)
        第五課 視頻教程 - 接口響應(yīng)與在線調(diào)試
        第六課 視頻教程 - Api接口層
        第七課 視頻教程 - Domain領(lǐng)域業(yè)務(wù)層與ADM模式解說
        第八課 視頻教程 - Model數(shù)據(jù)層與數(shù)據(jù)庫連接
        第九課 視頻教程 - 測試驅(qū)動開發(fā)與PHPUnit
        第十課 視頻教程 - 自動加載和PSR-4
        第十一課 視頻教程 - 接口文檔
        視頻教程 - 十分鐘體驗(yàn)PhalApi Pro，讓PHP接口開發(fā)更有趣！
        視頻教程 - 茶店應(yīng)用實(shí)戰(zhàn)

相關(guān)書籍

電子書：《初識PhalApi：探索接口服務(wù)開發(fā)的技藝》

作者：黃禪宗

圖靈社區(qū)鏈接：https://www.ituring.com.cn/book/2405

大綱：

獻(xiàn)詞
前言
第一部分 探索
第1章 遇見PhalApi
第2章 基礎(chǔ)入門
第3章 高級主題
第4章 不只是編碼
第二部分 項(xiàng)目案例
第5章 全新的創(chuàng)業(yè)項(xiàng)目
第6章 重寫歷史遺留項(xiàng)目
第7章 一個(gè)極致的項(xiàng)目
第三部分 再進(jìn)一步
第8章 PhalApi完美詮釋
第9章 如何有效設(shè)計(jì)接口框架
第10章 開源這條路
附錄A 接口服務(wù)文檔模板
致謝

電子書：《良質(zhì)！PHP企業(yè)級系統(tǒng)開發(fā)》

作者：黃禪宗

圖靈社區(qū)鏈接：https://www.ituring.com.cn/book/2664

大綱：

推薦序
前言
獻(xiàn)辭
第一部分 重新定義項(xiàng)目開發(fā)
第 1 章 軟件開發(fā)本質(zhì)論
第 2 章 選擇高起點(diǎn)
第 3 章 向世界發(fā)布你的代碼
第二部分 PHP高級編程
第 4 章 回歸原生態(tài)
第 5 章 PHPUnit單元測試新解
第三部分 PHP企業(yè)級系統(tǒng)開發(fā)
第 6 章 核心基礎(chǔ)模塊設(shè)計(jì)
第 7 章 大型網(wǎng)站開發(fā)范式
第 8 章 高可用接口服務(wù)系統(tǒng)
第 9 章 極致的管理后臺系統(tǒng)
第 10 章 深藏不露的計(jì)劃任務(wù)系統(tǒng)
第四部分 追求卓越
第 11 章 如何成為明星員工
第 12 章 贏在角色轉(zhuǎn)換
致謝

子項(xiàng)目

如果對PhalApi開源框架的內(nèi)部實(shí)現(xiàn)、源代碼和技術(shù)架構(gòu)感興趣，可以查看以下子項(xiàng)目。

• phalapi/kernal框架內(nèi)核
• phalapi/notorm數(shù)據(jù)庫包

PhalApi 2.x 版本的系統(tǒng)架構(gòu)如下：

PhalApi composer 擴(kuò)展

• phalapi/authAuth權(quán)限擴(kuò)展
• phalapi/cliCLI擴(kuò)展類庫
• phalapi/fast-routeFastRoute快速路由
• phalapi-aliyun-ossPhalApi-OSS阿里云OSS包
• phalapi/PHPMailer基于PHPMailer的郵件發(fā)送
• phalapi/qiniu七牛云存儲接口調(diào)用
• phalapi/qrcodePhalApi 二維碼擴(kuò)展
• phalapi/pinyinPhalApi 2.x 拼音擴(kuò)展
• phalapi/jwt基于PhalApi2的JWT拓展
• chenall/phalapi-weixin微信擴(kuò)展
• phalapi/wechatmini微信小程序擴(kuò)展
• phalapi/ding-com-bot釘釘企業(yè)內(nèi)部webhook機(jī)器人擴(kuò)展
• phalapi-pay支持微信支付和支付寶支付

溫馨提示：以上擴(kuò)展需要先通過composer安裝再使用。更多擴(kuò)展類庫的使用和開發(fā)，請參考文檔：PhalApi框架擴(kuò)展類庫：http://docs.phalapi.net/#/v2.0/library。

PhalApi應(yīng)用插件

• 運(yùn)營平臺插件
• 應(yīng)用用戶插件
• 加密解密插件
• 支付寶插件
• 茶店微信小程序應(yīng)用
• 在線接口文檔主題包

溫馨提示：應(yīng)用插件和composer擴(kuò)展的區(qū)別在于，應(yīng)用插件顆粒度更大，功能更具體，可能不僅有數(shù)據(jù)庫、接口、界面、還可能配合其他終端，并且不受composer的規(guī)范約束，是PhalApi自主發(fā)明和設(shè)計(jì)的開發(fā)方式。更多請參考：第三方應(yīng)用插件開發(fā)教程：http://docs.phalapi.net/#/v2.0/how-to-dev-plugin。

基于PhalApi開發(fā)的技術(shù)產(chǎn)品

以下產(chǎn)品均使用了PhalApi開源框架，并為官方自主研發(fā)的產(chǎn)品，歡迎個(gè)人/團(tuán)隊(duì)/企業(yè)使用。

接口大師-即刻搭建您的接口開放平臺(原名：PhalApi專業(yè)版)

產(chǎn)品官網(wǎng)：http://pro.phalapi.net/

果創(chuàng)云-后端低代碼開發(fā)平臺

產(chǎn)品官網(wǎng)：http://yesapi.cn/

YesDev協(xié)作云-在線協(xié)作你的全部項(xiàng)目

產(chǎn)品官網(wǎng)：https://www.yesdev.cn/

PhalApi 2.x 版本完美詮釋

2.x 版本系統(tǒng)架構(gòu)

主要分為三層：

• phalapi/phalapi 項(xiàng)目應(yīng)用層，可使用phalapi/phalapi搭建微服務(wù)、接口系統(tǒng)、RESTful、WebServices等。
• 擴(kuò)展類庫 擴(kuò)展類庫是指可選的、可重用的組件或類庫，可以直接集成使用，由廣大開發(fā)人員維護(hù)分享，對應(yīng)原來的PhalApi-Library項(xiàng)目。
• 核心框架 分別兩大部分，PhalApi核心部分kernal，以及優(yōu)化后的notorm。

其中，各自的composer和github項(xiàng)目分別是：

框架核心部分UML靜態(tài)結(jié)構(gòu)圖

PhalApi 2.x 版本的核心框架部分的UML靜態(tài)結(jié)構(gòu)圖，高清版如下所示：

首先，綠色部分的PhalApi\PhalApi類是整個(gè)接口系統(tǒng)的訪問入口，也就是項(xiàng)目應(yīng)用系統(tǒng)、客戶端使用的關(guān)鍵所在。相關(guān)的調(diào)用代碼，可以參考統(tǒng)一入口文件的實(shí)現(xiàn)代碼片段。

$pai=new \PhalApi\PhalApi();
$pai->response()->output();

只需要兩行代碼，便可完成對接口服務(wù)的請求響應(yīng)。

其次，是黃色部分的Api、Domain和Model這三層，也就是我們常說的ADM分層架構(gòu)。這部分，需要開發(fā)人員關(guān)注，因?yàn)檫@也是具體項(xiàng)目開發(fā)需要自己實(shí)現(xiàn)的部分。

最后，是紅色部分的DI依賴注入，也是整個(gè)框架的核心所在。不僅在核心框架中使用頻率最高，乃至在項(xiàng)目應(yīng)用中也會經(jīng)常被用到。

核心執(zhí)行流程時(shí)序圖

PhalApi 2.x 版本的核心執(zhí)行流程時(shí)序圖，與1.x 版本基本一致，可以看出，不管技術(shù)如何升級，PhalApi的最初的核心時(shí)序流程仍保持著活力。唯一變化的是各個(gè)類名。

代碼倉庫

Gitee碼云 - PhalApi開源接口框架（1.7k Star）

代碼鏈接：https://gitee.com/dogstar/PhalApi

Github - PhalApi開源接口框架（1.4 Star）

代碼鏈接：https://github.com/phalapi/phalapi

版本更新

2021年7月發(fā)布更新了 PhalApi 2.17.2 版本。

PhalApi 2.17.2 版本

[BUG修復(fù)]

1、SQL記錄，只提取部分必要的參數(shù)，避免全部記錄，以及避免記錄密碼等敏感信息到日志文件

2、翻譯和DataApi參數(shù)說明補(bǔ)充

3、DataModel調(diào)用不存在方法時(shí)的異常提示信息，去掉多余的美元符號

4、在線接口文檔模板判斷調(diào)整，避免出現(xiàn)warning

更多歷史版本更新日記，請查看：

http://docs.phalapi.net/#/v2.0/changelog

近在各種網(wǎng)站、論壇逛了幾圈，收集了不少實(shí)用的api，為大家提供一點(diǎn)點(diǎn)幫助。。。

一.天氣類api

1.天氣api：

www.tianqiapi.com

(1)實(shí)況天氣(基本天氣信息、濕度、能見度、氣壓、空氣質(zhì)量指數(shù)等)

最快3小時(shí)更新一次

(2)七日天氣(基本天氣信息、氣象預(yù)警、濕度、能見度、氣壓、日出日落、每日小時(shí)預(yù)報(bào)、6大生活指數(shù)等)

最快三小時(shí)更新一次

(3)全國天氣降水量預(yù)報(bào)圖(未來24，48，70小時(shí)預(yù)報(bào)圖片url地址)

每兩小時(shí)更新一次

專業(yè)版可獲取信息更詳細(xì)，具體內(nèi)容查看api文檔，下同

2.和風(fēng)api:

?dev.heweather.com

(1)常規(guī)天氣數(shù)據(jù)(未來三天日夜天氣狀況，日最高(低)氣溫，日(月)出(落)時(shí)間， 風(fēng)速，風(fēng)力，風(fēng)向，降水概率，降水量，大氣壓強(qiáng)，能見度，紫外線強(qiáng)度)

(2)空氣質(zhì)量數(shù)據(jù)(查詢地區(qū)內(nèi)監(jiān)測站的名稱、位置和ID，空氣污染指數(shù)，各種污染物(PM10,PM2.5,NO2,SO2,CO,O3)的數(shù)值)

3.心知天氣：

docs.seniverse.com

(1)天氣實(shí)況(天氣狀況，氣溫)

(2)逐日天氣預(yù)報(bào)(未來三日內(nèi)，日最高(低)氣溫，風(fēng)速，風(fēng)力，風(fēng)向，降水率)

4.彩云api：

wiki.swarma.net

好像更新了。。。具體內(nèi)容查看api文檔

5.免費(fèi)天氣查詢：

?www.sojson.com

6.丫丫天氣：

www.yytianqi.com

7.天行數(shù)據(jù)天氣接口：

www.tianapi.com

天行數(shù)據(jù)其他api接口：

www.tianapi.com

這個(gè)大概是用過最好的api網(wǎng)站，白嫖狀態(tài)下贈送次數(shù)最多，按次計(jì)費(fèi)也不算太貴

二.聊天機(jī)器人

1.海知智能：

1. docs.ruyi.ai

不光能聊天，還可以在網(wǎng)站里內(nèi)置技能，實(shí)現(xiàn)(翻譯，成語接龍等)數(shù)十項(xiàng)功能

2.天行機(jī)器人：

www.tianapi.com

白嫖用戶綁定微信后有40000次永久額度，之后1元10000次

3.思知機(jī)器人：

www.ownthink.com

4.青云客智能機(jī)器人：

api.qingyunke.com

5.圖靈機(jī)器人：

?www.turingapi.com

圖靈的官網(wǎng)如果不充值好像每日請求次數(shù)很低很低，但好在可以通過其他api網(wǎng)站進(jìn)行調(diào)取www.tianapi.com

6.小i機(jī)器人：

模版展示頁面?nlp.xiaoi.com

但小i機(jī)器人沒有api使用文檔，想要使用就只能自己分析

import urllib.request

import re

message=“”

msg=urllib.parse.quote(message)

link=urllib.request.urlopen("http://nlp.xiaoi.com/robot/webrobot&callback=__webrobot_processMsg&data=%7B%22sessionId%22%3A%22ff725c236e5245a3ac825b2dd88a7501%22%2C%22robotId%22%3A%22webbot%22%2C%22userId%22%3A%227cd29df3450745fbbdcf1a462e6c58e6%22%2C%22body%22%3A%7B%22content%22%3A%22"+msg+"%22%7D%2C%22type%22%3A%22txt%22%7D")

html_doc=link.read().decode()

reply=re.findall(r'\"content\":\"(.+?)\r\n\"', html_doc)

print(reply)

可以通過這段python代碼進(jìn)行輸入并取得輸出

三.垃圾分類

垃圾分類的api好像不是太多，就推薦一個(gè)好用的吧

www.tianapi.com

四.新聞推送

1.百度新聞：

python 代碼：

import re

url="http://news.baidu.com/"

header={'User-Agent':'UserAgent:Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0)'}

req=urllib.request.Request(url,headers=header)

res=urllib.request.urlopen(req)

html=res.read().decode("utf-8")

pat='<a href=" " .*? target="_blank">(.*?)</a >'

data=re.findall(pat,html)

for v in data:

if "#" not in v[1]:

print(v[1]+":"+v[0])

2.NBA新聞：

www.tianapi.com

好像因?yàn)橐咔榫壒剩瑔T工還沒開始上班，網(wǎng)站數(shù)據(jù)還是春節(jié)前的，等疫情過了再說

新聞?lì)惖慕涌谶€有很多，可以在各種api網(wǎng)站上查詢，就不一一列舉了

五.快遞

1.快遞鳥api：

www.kdniao.com

但是調(diào)取這個(gè)api需要接口鑒權(quán)，對與我們小白好像不太友好……所以：

2.天行api

www.tianapi.com

但天行的這個(gè)api有點(diǎn)小貴，注冊只送50額度，之后1元100次，酌情選用

六.人臉識別

1.Face++

人臉檢測 - Face++人工智能開放平臺?www.faceplusplus.com.cn

主要功能：

1.對圖片進(jìn)行人臉檢測和分析(Detect)

2.比對兩張圖片中的人臉是否為同一人(Compare)

3.在圖片中尋找與目標(biāo)人臉最相似的一張或多張人臉(Search)

4.對圖片進(jìn)行美顏(美白，磨皮)，美型(大眼，瘦臉，小臉，去眉毛等)，增加濾鏡等(Beautify)

5.皮膚分析(膚質(zhì)，單雙眼皮，有無眼袋、黑眼圈、抬頭紋、青春痘、黑頭、法令紋等)

6還可以對車牌，證件等進(jìn)行識別，具體見api文檔

?console.faceplusplus.com.cn

2.天行數(shù)據(jù)

相比于Face++想要簡潔一些，只進(jìn)行簡單的識別，不需要太過復(fù)雜的功能，可以選用此api

www.tianapi.com

七.翻譯

1.有道詞典：

?fanyi.youdao.com

2.金山詞霸：

http://open.iciba.com/?c=api?open.iciba.com

3.百度翻譯：

?api.fanyi.baidu.com

八.社交

1.微博：

open.weibo.com

附一個(gè)github上比較成熟的項(xiàng)目：

https://github.com/dataabc/weiboSpider?github.com

2.b站：

blog.csdn.net里面都可以找到：

(1)b站實(shí)時(shí)在線人數(shù)與最新投稿

(2)視頻彈幕

(3)評論區(qū)留言

(4)視頻下載：盡管github上有這類項(xiàng)目，但要么有的分段下載，有的視頻音頻分開下，有點(diǎn)麻煩…所以還是推薦一個(gè)you-get的python庫吧。。。

You-Get 使用方法www.jianshu.com不光能下b站視頻還支持?jǐn)?shù)十個(gè)國內(nèi)外主流視頻網(wǎng)站，但實(shí)測好像有些不行，具體可以自己嘗試

3.沙雕app：https://shadiao.app/

這個(gè)沒有現(xiàn)成的api可以調(diào)用，但可以去網(wǎng)站找客服郵箱，它會要求你給出標(biāo)識符以及域名或者ip地址，然后給你可以調(diào)用的api。主要功能有：

(1)彩虹屁生成器

(2)罵人寶典/撕逼生成器

(3)朋友圈文案生成器

(4)毒雞湯生成器

強(qiáng)調(diào)一點(diǎn)：這玩意罵人是真的狠，非常不適宜用于朋友之間開玩笑，建議有切實(shí)需要再進(jìn)行使用！！

九.圖床

由于api大多采取的post，get傳輸方式都無法直接傳輸圖片，只能傳送url地址，而有時(shí)需要傳輸?shù)氖莿偱某鰜淼谋镜貓D片，還沒有url。盡管可以手動傳送上網(wǎng)來獲取url，但無法自動操作，很麻煩(我自己就被這個(gè)東西困擾了好久…)最后采用的sm.ms圖床解決

官網(wǎng)：https://sm.ms/

api文檔：https://doc.sm.ms/

python代碼

head={'Authorization':'OJ9QijpjOLz0DtL8Yxr3ZDOCzHgpMBQl'}

files={'smfile':open(msg['FileName'],'rb')} reply=requests.post('https://sm.ms/api/v2/upload',headers=head,files=files,verify=False)

reply=json.loads(reply.text)

if reply['success']==False:

reply=reply['images']

else:

reply=reply['data']['url']

url=reply

print(url)

sm.ms圖床提供了5個(gè)G的空間，感覺還是挺足夠的，實(shí)在不行，還可以去刪。

十.武漢新型冠狀病毒疫情信息接口(COVID-19)

疫情來勢洶洶，人們對疫情充滿了關(guān)切。盡管能通過各種各樣的渠道獲得疫情播報(bào)，從微信小程序、支付寶上獲得各種數(shù)據(jù)，但如題要制作一個(gè)app的話，好像還是調(diào)用api方便點(diǎn)。。。

疫情數(shù)據(jù)：https://www.tianapi.com/apiview/170

疫情播報(bào)：https://www.tianapi.com/apiview/169

同程查詢：https://www.tianapi.com/apiview/172

周邊疫情：https://www.tianapi.com/apiview/173

謠言鑒別：https://www.tianapi.com/apiview/171

再放一個(gè)大佬利用這幾個(gè)接口制作的疫情信息軟件

原貼地址：https://www.52pojie.cn/thread-1096810-1-1.html

百度云鏈接：https://pan.baidu.com/s/1ZtsXAa7zWNtFrqM88R94cg提取碼：tavr

藍(lán)奏云鏈接：

https://www.lanzous.com/b0ddqluuj提取碼：8888

十一.藍(lán)奏云

順手安利一下上邊那個(gè)跟百度網(wǎng)盤不一樣的網(wǎng)盤…

https://www.lanzou.com?

優(yōu)點(diǎn)：免費(fèi)使用，空間存儲無限制，下載無限制，不用下載客戶端，上傳下載都不限速，分享文件地址永久有效

缺點(diǎn)：無限空間但單個(gè)文件只能上傳100M

最后幾點(diǎn)tips：

1.推薦的最多的還是天行數(shù)據(jù)api，也可能是因?yàn)樽约河玫谋容^多。注冊地址：

www.tianapi.com

2.上述api大多不需要接口鑒權(quán)，較為適合小白使用，只需注冊得要api_key就可以調(diào)用。還有其他大廠的api網(wǎng)站如騰訊AI開放平臺，百度AI開放平臺等需要接口鑒權(quán)，也有很多不錯(cuò)的api可供免費(fèi)調(diào)用。

3.最后也是最關(guān)鍵的一條：不需要接口鑒權(quán)大大降低了api調(diào)用門檻，調(diào)用api時(shí)應(yīng)仔細(xì)閱讀開放文檔，了解接口更新頻率和時(shí)間，及時(shí)做好緩存，減小api提供方帶寬消耗所帶來的超額運(yùn)營支出成本。

以后有時(shí)間再詳細(xì)更…