【文章內(nèi)容簡(jiǎn)介】 203 授權(quán)碼錯(cuò)誤或者已過期 204 用戶或授權(quán)服務(wù)器拒絕授予數(shù)據(jù)訪問權(quán)限，比如當(dāng)用戶撤回了應(yīng)用的OAuth2訪問權(quán)限后再去調(diào)獲取訪問令牌接口會(huì)出現(xiàn)這個(gè)錯(cuò)誤 205 grant_type值無效或者不支持，目前grant_type值只能為 authorization_code或 client_credentials 206 xpired access_token無效或者已過期 207 用戶登陸失敗， 用戶名或密碼錯(cuò)誤 406 _word 搜索詞中包含敏感詞匯 500 調(diào)用開放平臺(tái)內(nèi)部服務(wù)發(fā)生錯(cuò)誤 501 調(diào)用第三方服務(wù)發(fā)生錯(cuò)誤 502 未知服務(wù)器錯(cuò)誤 每個(gè)應(yīng)用都有調(diào)用請(qǐng)求頻率限制，如果超出限制就會(huì)返回 104 錯(cuò)誤碼。目前限制規(guī)則如下： ? 測(cè)試環(huán)境：每個(gè)應(yīng)用每分鐘限額 200 次，每個(gè)應(yīng)用每小時(shí)限額 3000 次 ? 線上環(huán)境：待定 、 HTTP 響應(yīng)碼 HTTP 響應(yīng)碼說明如下： 響應(yīng)碼 描述 200 請(qǐng)求成功 201 創(chuàng)建成功 202 更新成功 301 請(qǐng)求永久重定向 302 請(qǐng)求臨時(shí)重定向 304 未更改 400 請(qǐng)求地址不存在或者包含不支持的參數(shù) 401 未授權(quán)，因?yàn)槲闯晒M(jìn)行身份認(rèn)證 403 被禁止訪問，因?yàn)闆]有訪問特定資源的權(quán)限 404 請(qǐng)求的資源不存在 422 服務(wù)器理解請(qǐng)求，但其中包含非法參數(shù)（如包含 XSS 攻擊風(fēng)險(xiǎn)參數(shù)） 429 調(diào)用請(qǐng)求頻率超出限額 500 服務(wù)器內(nèi)部錯(cuò)誤 OpenAPI 數(shù)據(jù)接口調(diào)用流程 、身份認(rèn)證 在調(diào)用具體的 API數(shù)據(jù)接口前需要先通過 OAuth2接口獲取 access_token訪問令牌。 具體流程如下： a、客戶端向喜馬拉雅授權(quán)服務(wù)器進(jìn)行身份認(rèn)證，并要求一個(gè)訪問令牌。請(qǐng)求示例如下（注意 X指定是 HTTP POST請(qǐng)求， d指定請(qǐng)求參數(shù)）： curl X POST d client_id=[app_key]amp。device_id=[設(shè)備唯一標(biāo)識(shí) ]amp。grant_type=client_credentialsamp。nonce=[隨機(jī)字符串 ]amp。timestamp=1453116822556amp。sig=[簽 名 ] 身份認(rèn)證接口的所有參數(shù)已經(jīng)如上列舉了。 參數(shù)說明如下： client_id： 即 app_key，應(yīng)用公鑰 grant_type：固定值 client_credentials device_id： 設(shè)備唯一標(biāo)識(shí) ，比如對(duì)于 Android手機(jī)可以取 imei，其他物理設(shè)備可以取 MAC地址 nonce：隨機(jī)字符 串 ， 長(zhǎng)度建議 832位， 每次請(qǐng)求都要重新生成 timestamp： Unix毫秒數(shù)時(shí)間戳， 每次請(qǐng)求都要重新生成 sig：根據(jù) 參數(shù) 另外 注意：該請(qǐng)求的請(qǐng)求頭 ContentType必須是 application/xformurlencoded b、喜馬拉雅授權(quán)服務(wù)器確認(rèn)請(qǐng)求參數(shù)無誤后，向客戶端返回 access_token訪問令牌，以 JSON形式返回如下 （ 注意： access_token有過期時(shí)間，默認(rèn)過期時(shí)間為 1天，過期后需要重新獲取 ） ： { access_token: b994eebe844fcfcfaa62ecef523ee507, expires_in: 86400 // access_token過期時(shí)間，單位為秒 } 如果使用過期或者失效的 access_token請(qǐng)求 API，會(huì)返回如下響應(yīng)： { error_no: 206, error_code: , error_desc: access_token is invalid or expired } 這種情況就需要重新請(qǐng)求獲得 access_token。 、 OpenAPI 數(shù)據(jù)接口調(diào)用說明 、點(diǎn)播數(shù)據(jù)接口調(diào)用說明 點(diǎn)播接口調(diào)用步驟一般如下： 1. 先調(diào)用 /categories/list接口獲取喜馬拉雅點(diǎn)播數(shù)據(jù)分類； 2. 然后根據(jù)上一步得到的 category_id（分類 ID）調(diào)用 /tags/list接口獲取某個(gè)分類下專輯標(biāo)簽或者聲音標(biāo)簽： 3. 最后根據(jù)分類和標(biāo)簽就可以調(diào)用熱門專輯接口或熱門聲音接口得到熱門專輯列表 和熱門聲音列表 另外還可以通過下面兩種方法獲取專輯或聲音數(shù)據(jù)： 1. 根據(jù)一批專輯 ID或者一批聲音 ID，分別調(diào)用 /albums/get_batch、 /tracks_get_batch接口批量獲取專輯或聲音數(shù)據(jù) 2. 調(diào)用 /search/albums接口和 /search/tracks接口搜索某個(gè)分類下滿足某個(gè)搜索詞的專輯或聲音數(shù)據(jù) 、直播數(shù)據(jù)接口調(diào)用說明 直播數(shù)據(jù)接口的調(diào)用步驟一般如下： 1. 如果要獲取非省市直播電臺(tái)數(shù)據(jù)，則直接調(diào)用 /live/radios接口；如果要獲取省市直播電臺(tái)數(shù)據(jù)，則先調(diào)用 /live/provinces接口獲取省市列表數(shù)據(jù)，然后再調(diào)用/live/radios接口 2. 得到直播電臺(tái) ID后，既可以調(diào)用 /live/schedules接口獲取直播電臺(tái)節(jié)目排期數(shù)據(jù)，也可以調(diào)用 /live/get_playing_program接口獲取該直播電臺(tái)正在直播的節(jié)目 API 數(shù)據(jù)接口 、點(diǎn)播接口 、 /categories/list 功能 獲取喜馬拉雅內(nèi)容分類 HTTP Method GET 參數(shù) 公共參數(shù) 返回值 返回分類列表，每個(gè)分類包含下列字段： 字段名 類型 描述 id Int 分類 ID kind String 固定值 category category_name String 分類名 cover_url_small String 分類封面小圖 cover_url_middle String 分類封面中圖 cover_url_large String 分類封面大圖 order_num Int 排序值，值越小排序越在前 實(shí)例 URL d5de66fceb37da3amp。client_os_type=2amp。device_id=df529d6e9b56c15bamp。pack_id=amp。access_token=77eca96155c50179141549792edb7570amp。sig=xxx 響應(yīng)內(nèi)容 [ { id: 1, kind: category, category_name: 最新資訊 , cover_url_small: xxx, cover_url_middle: xxx, cover_url_large: xxx, order_num: xxx }, ...... ] 注意事項(xiàng) ? 分類 ID 為 0 是熱門分類，但該接口不返回 ID 為 0 的熱門分類 、 /v2/tags/list 功能 獲取專輯或聲音的標(biāo)簽（ v2 版本標(biāo)簽）。 HTTP Method GET 參數(shù) 除公共參數(shù)外還包括下列參數(shù)： 字段名 類型 必填 描述 category_id Int 是 分類 ID，指定分類，為 0 時(shí)表示熱門分類 type Int 是 指定查詢的是專輯標(biāo)簽還是聲音標(biāo)簽， 0專輯標(biāo)簽， 1聲音標(biāo)簽 返回值 返回標(biāo)簽列表，每個(gè)標(biāo)簽包含下列字段： 字段名 類型 描述 tag_name String 標(biāo)簽名 kind String 固定值 tag 實(shí)例 URL de66fceb37da3amp。client_os_type=2amp。device_id=df529d6e9b56c15bamp。pack_id=amp。access_token=77eca96155c50179141549792edb7570amp。category_id=3amp。type=0amp。sig=xx 響應(yīng)內(nèi)容 [ { tag_name: 脫口秀 , kind: tag, }, { tag_name: 排行榜 , kind: tag, }, ... ] 、 /v2/albums/list 功能 根據(jù)分類和標(biāo)簽獲取某個(gè)分類某個(gè)標(biāo)簽下的熱門專輯列表 /最新專輯列表 /最多播放專輯列表（ v2 版本） HTTP Method GET 參數(shù) 除公共參數(shù)外還包括下列參數(shù)： 字段名 類型 必填 描述 category_id Int 是 分類 ID，指定分類，為 0 時(shí)表示熱門分類 tag_name String 否 分類下對(duì)應(yīng)的專輯標(biāo)簽，不填則為熱門分類 calc_dimension Int 是 計(jì)算維度，現(xiàn)支持最火（ 1），最新（ 2），經(jīng)典或播放最多（ 3） page Int 否 返回第幾頁，必須大于等于 1，不填默認(rèn)為 1 count Int 否 每頁多少條，默認(rèn) 20，最多不超過 200 返回值 字段名 類型 描述 total_page Int 總共多少頁 total_count Int 專輯總數(shù) current_page int 當(dāng)前頁碼 category_id Int 分類 ID，為 1 時(shí)表示不屬于任何分類 tag_name String 選填的標(biāo)簽名，無則返回空字符串 ”” albums Array 專輯列表，每個(gè)專輯包含下列字段： ? id：專輯 ID ? kind:固定值 album ? album_title：專輯名稱 ? album_tags：專輯標(biāo)簽列表 ? album_intro：專輯簡(jiǎn)介 ? cover_url_small：專輯封面小圖 ? cover_url_middle：專輯封面中圖 ? cover_url_large：專輯封面大圖 ? announcer：專輯所屬主播信息，包括 id（主播用戶 ID）、 nickname（昵稱）、 avatar_url（頭像）和 is_verified（是否加 V） ? play_count：專輯播放次數(shù) ? favorite_count：專輯喜歡數(shù) ? include_track_count：專輯包含聲音數(shù) ? last_uptrack：專輯中最新上傳的一條聲音信息，包括 track_id、 track_title、 duration、 created_at、updated_at 字段 ? remend_track：熱門專輯推薦的聲音 { uid: 主播 ID， human_remend_track_id：聲音 ID human_remend_real_title：聲音真實(shí)標(biāo)題 human_remend_track_title：運(yùn)營(yíng)推薦標(biāo)題 } ? is_finished：是否完結(jié)， 0無此屬性； 1未完結(jié)；2完結(jié) ? can_download：能否下載， 布爾值 ， true可下載， false不可 下載 ? updated_at：專輯更新時(shí)間， Unix 毫秒數(shù)時(shí)間戳 ? created_at：專輯創(chuàng)建時(shí)間， Unix 毫秒數(shù)時(shí)間戳 實(shí)例 URL d5de66fceb37da3amp。client_os_type=2amp。device_id=df529d6e9b56c15bamp。pack_id=amp。access_token=77eca96155c50179141549792edb7570amp。category_id=3amp。tag_name=%E6%B5%AA%E6%BC%AB%E8%A8%80%E6%83%85amp。page=1amp。count=20amp。sig=xxx 響應(yīng)內(nèi)容 { category_id: 3, total_page: 20, total_count: 393, current_page: 1, tag_name: 浪漫言情 , albums: [ { id: 2885924, kind: album, category_id: 3, album_title: 我不喜歡這世界，我只喜歡你 , album_tags: 我不喜歡這個(gè)世界 ,我只喜歡你 ,擲地有聲 ,言情 , album_intro: 《我不喜歡這世界，我只喜歡你》 , cover_url_sm