接口測試：A01

完成測試內容：

1. 被測接口： PM 2.5 空氣質量報告
2. 發送請求： 向該接口發送獲得某個城市（如北京）空氣質量的 HTTP 請求
3. 斷言響應： 判斷返回的HTTP響應代碼及內容是否符合預期

一. 被測接口說明

學習接口測試就要有實際接口的案例，這裡我們使用 pm25.in 站點提供的用於學習和測試的公開接口，通過對接口的訪問，可以實時獲取 PM 2.5 的空氣質量數據。

接口說明官網地址：http://www.pm25.in/api_doc

接口的主要功能

1. pm25.in 是免費提供空氣質量數據的一個公益性網站，其數據全部來源於網友提供的國家環保網站公開數據。

2. 該接口接收 HTTP 請求，響應 JSON 格式數據。

3. 目前不提供歷史數據，只提供最近一小時的數據。

4. 初學者、用於測試者可以使用公共測試 AppKey（AppKey = 5j1znBVAsnSf5xQyNQyq）。

5. 該公共 AppKey 用於測試和學習，每小時有訪問次數的限制。

接口詳細描述

請求地址：http://www.pm25.in/api/querys/pm2_5.json

請求方法：GET

請求參數：

• city：必填，城市名稱，可以使用中文城市名稱，如“珠海”，也可以使用拼音，如“zhuhai”
• token：必填，AppKey（此處我們使用公開的）

返 回 值：一個 JSON 數組，裡面的每一項對應一個監測點的PM2.5信息

請求示例：

• http://www.pm25.in/api/querys/pm2_5.json?city=珠海&token=xxxxxx
• http://www.pm25.in/api/querys/pm2_5.json?city=zhuhai&token=xxxxxx

請求成功返回數據格式如下：

<code>[
    {
        "aqi": 82,
        "area": "珠海",
        "pm2_5": 31,
        "pm2_5_24h": 60, 

        "position_name": "吉大",
        "primary_pollutant": "顆粒物(PM2.5)",
        "quality": "良",
        ..................
    },
    .....
]/<code>

請求失敗返回錯誤信息，如下：

<code>{ "error": "參數不能為空" }
{ "error": "該城市還未有PM2.5數據" }
{ "error": "Sorry，您這個小時內的API請求次數用完了，休息一下吧！" }
{ "error": "You need to sign in or sign up before continuing." }/<code>

補充知識：關於AppKey

1. 公司的接口一般是不會隨意暴露到公眾視線的，這裡涉及數據和安全等多方面的因素，所以接口的訪問就要設置身份認證和相關權限了，該網站要求在請求 pm2.5 接口數據的時候，必須附帶一個 AppKey 用於你身份的認證。

2. 目前該網站提供了一個公開用於測試的 Appkey，所有人都可以使用，但是每小時內有訪問次數的限制。請大家不要進行學習以外的用途。如果想擁有自己獨立的 AppKey，則可以在官網頁面自行申請。

閱讀更多 捉蟲客 的文章

關鍵字: 珠海 接口 測試