1. 身份认证和鉴权

调用API需要使用AccessKeyId和AccessKeySecret来进行身份认证和鉴权。AccessKeyId和AccessKeySecret由天猫精灵酒店行业平台颁发，获取方法如下。

首先需要在应用管理申请pop调用的身份信息（accessKey，accessSecret）。

链接https://business.aligenie.com/setting/application?hotelId=xxx 酒店的id请替换成自己的

或者直接平台上点击如下tab：设置-应用管理

步骤：新建一个应用，建好了后会自动生成pop调用的身份信息，当调用pop接口时会需要用到ak和sk。

2. API调用方式

集成SDK

天猫精灵酒店行业平台提供的Java SDK，可帮助开发人员通过Java程序更便捷地操作AI平台。开发人员可以添加包含Maven依赖的SDK，也可以下载安装包到本地直接安装。

安装SDK

1. 安装Java开发环境。您可以从Java 官方网站下载，并按说明安装Java开发环境。

2. 选择以下任一方式，安装AI平台的Java SDK。

• 访问天猫精灵OpenAPI中心，选择SDK示例 > Java页签，并单击下载完整工程获取SDK。

• 添加Maven项目依赖。配置Maven的操作，可参见Maven使用指南。

//本文档中展示的版本号仅作参考，请在OpenAPI控制台中获取最新版本SDK。

3. API在线调试

天猫精灵OpenAPI开发者门户提供了API在线调试工具。在API调试页面，您可以快速检索和体验调用API。平台会根据您输入的参数同步生成各语言SDK的代码示例。

在调用结果页签下，您可以查看API调用的真实请求URL和JSON格式的返回结果。如果返回结果中出现错误码，您可以在错误码字典中查看相应的描述，快速进行问题定位。

4. 示例代码

天猫精灵OpenAPI开发者门户提供了多种语言的SDK示例代码，包括Java、Python、nodeJs等。

在SDK示例页签下，您可以查看各语言SDK代码示例，以及下载该语言的完整工程。SDK的具体介绍，请参见如上的API调用方式。

5. 错误码字典

目前错误码都是放在message里的，具体的错误详情见message详情，统一的code如下