POST/v1/hotels/reviews

获取酒店评论

返回指定酒店和语言的已存储评论,用于丰富酒店详情页。

分享

返回指定酒店和语言的已存储评论,用于丰富酒店详情页。

接口

方法路径认证
POST/v1/hotels/reviews需要 API key
必需请求头:
Header说明
AuthorizationBearer <secret_key>. The secret is shown only once when the credential is created.
X-Travelandz-Id<public_key>:<profile_code>. The profile_code is the dp_-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
Content-TypeUse application/json for requests with a body.

Request Parameters

不需要路径参数或查询参数。

请求体结构

hotelId
string
language
enum
eneszh

成功响应

返回 review entries and provider metadata.

响应体结构

language
enum
eneszh
reviews
array
reviews[]name
string
reviews[]relativePublishTimeDescription
string
reviews[]text
object
reviews[]texttext
string
reviews[]textlanguageCode
string
reviews[]originalText
object
reviews[]originalTexttext
string
reviews[]originalTextlanguageCode
string
reviews[]rating
number
reviews[]authorAttribution
object
reviews[]authorAttributiondisplayName
string
reviews[]authorAttributionuri
string
reviews[]authorAttributionphotoUri
string
reviews[]publishTime
string
reviews[]flagContentUri
string
reviews[]googleMapsUri
string
reviews[]visitDate
object
reviews[]visitDateyear
number
reviews[]visitDatemonth
number
reviews[]visitDateday
number
liveMode
boolean
True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

示例

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/hotels/reviews \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'