新版本内容 API 说明

旧版本的 Dida 内容 API 以 CSV 格式返回了许多关于酒店的静态信息，这些信息过于庞大且不便于客户处理。为了使 Dida API 客户更轻松、更快速地获取与 Dida 酒店相关的静态数据，对以前的版本进行了更改，推出了这个新版本的内容API。Dida酒店的静态信息现在将在API中以JSON格式返回，使客户访问更加方便。
新版本于2025年1月发布。对于新的API客户，强烈建议使用新版本。

域名

请注意，测试账户的域名与正式账户的域名相同。

https://static-api.didatravel.com

API 列表

请注意，通过接口访问静态内容时存在QPS（每秒查询次数）限制。例如，如果QPS设置为10，则表示每秒最多支持10个请求。如果超过10个请求，可能会被阻止。

Url	描述	默认QPS请求量
/api/v1/region/counties	此API用于检索国家列表	10
/api/v1/region/destinations	此API用于检索特定国家的目的地列表	1
/api/v1/hotel/list	此API用于检索特定国家的酒店列表	1
/api/v1/hotel/details	此API用于检索特定酒店ID列表的酒店详细信息	10

授权

当前API使用基本访问认证（Basic access authentication）。请使用ClientID作为用户名，LicenseKey作为密码。

授权示例

请注意，DidaApiTestID是一个通用测试账户，每个国家只能查看10家酒店。如果您需要访问更多酒店信息，请联系您的专属API客户经理。

用户名: DidaApiTestID
密码: TestKey
凭证 = Base64(DidaApiTestID:TestKey) // RGlkYUFwaVRlc3RJRDpUZXN0S2V5

curl -X 'GET' \
  'https://static-api.didatravel.com/api/v1/region/countries?language=en-US' \
  -H 'accept: application/json' \
  -H 'Authorization: Basic RGlkYUFwaVRlc3RJRDpUZXN0S2V5'

多语言

Dida 目前支持的语言包括英语、中文、日语、韩语、葡萄牙语（巴西）以及 西班牙语。大多数酒店有英文的静态信息，但其他语言的覆盖可能不那么广泛，Dida 正在努力改进这一点。

如果您想获取其他语言的静态信息，可以将 "language=en-US" 中的语言代码更改为相应的语言代码，如下所示：

语言	代码
Chinese	zh-CN
Japanese	ja-JP
Korean	ko-KR
Brazilian Portuguese	pt-BR
Spanish	es-ES

请注意，非默认测试帐户默认仅支持英语。如果您需要其他语言的静态信息，请联系您的专属 API 客户经理。

Gzip

为了优化数据传输，所有请求都应接受 gzip 编码。同样，所有响应消息都以 gzip 编码返回，以确保高效、快速的数据传输。