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