攜程獲取景點詳情 API 返回值說明

Noah_WB發表於2024-03-13

公共引數

請求地址:

名稱

型別

必須

描述

key

String


呼叫key,必須以GET方式拼接在URL中)

secret

String


呼叫金鑰

api_name

String


API介面名稱(包括在請求地址中)[item_search,item_get,item_search_shop等]

cache

String


[yes,no]預設yes,將呼叫快取的資料,速度比較快

result_type

String


[json,jsonu,xml,serialize,var_export]返回資料格式,預設為json,jsonu輸出的內容中文可以直接閱讀

lang

String


[cn,en,ru]翻譯語言,預設cn簡體中文

version

String


API版本

請求引數

請求引數:num_iid=138153

引數說明:num_iid:景點id,

響應引數

Version: Date:2024-01-21

名稱

型別

必須

示例值

描述

item

item[]

0


攜程旅行景點詳情資料

address

Str

0


景點地址

area_id

Str

0


區域ID

desc

Str

0


景點描述

desc_img

Str

0


圖片描述

detail_url

Str

0


詳細地址

hot

Str

0


景點熱度

item_imgs

Str

0


景點主圖列表

level

Str

0


景區等級

open_time

Str

0


景點開放時間

poiid

Str

0


獲取評論ID

ranking

Str

0


景點排名

reviews_num

Int

0


評論總數

score

Int

0


景點評分

service

Str

0


服務政策

telephone

Str

0


景點電話

tips

Str

0


提示資訊

title

Str

0


景點標題

upgrade

Str

0


優待政策

請求示例

-- 請求示例 url 預設請求引數已經URL編碼處理
curl -i "您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=138153"

響應示例


異常示例

{
  "error": "item-not-found",
  "reason": "沒找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2023-12-15 17:44:00",
  "call_args": [],
  "api_type": "xiecheng",
  "request_id": "1ee0ffc041242"}

相關資料錯誤碼解釋

狀態程式碼(error_code)

狀態資訊

詳細描述

是否收費

0000

success

介面呼叫成功並返回相關資料


2000

Search success but no result

介面訪問成功,但是搜尋沒有結果


4000

Server internal error

伺服器內部錯誤


4001

Network error

網路錯誤


4002

Target server error

目標伺服器錯誤


4003

Param error

使用者輸入引數錯誤

忽略

4004

Account not found

使用者帳號不存在

忽略

4005

Invalid authentication credentials

授權失敗

忽略

4006

API stopped

您的當前API已停用

忽略

4007

Account stopped

您的賬戶已停用

忽略

4008

API rate limit exceeded

併發已達上限

忽略

4009

API maintenance

API維護中

忽略

4010

API not found with these values

API不存在

忽略

4012

Please add api first

請先新增api

忽略

4013

Number of calls exceeded

呼叫次數超限

忽略

4014

Missing url param

引數缺失

忽略

4015

Wrong pageToken

引數pageToken有誤

忽略

4016

Insufficient balance

餘額不足

忽略

4017

timeout error

請求超時


5000

unknown error

未知錯誤



來自 “ ITPUB部落格 ” ,連結:https://blog.itpub.net/70026910/viewspace-3005730/,如需轉載,請註明出處,否則將追究法律責任。

相關文章