什么是生活物联网平台API_生活物联网平台（飞燕平台）-阿里云帮助中心

调用生活物联网平台API时，您需要了解API的公共信息，包括网关协议与地址、调用方法、请求参数、返回参数等。

调用客户端API与调用云端API需要使用不同的AppKey和AppSecret来进行身份认证和鉴权。AppKey和AppSecret由生活物联网平台颁发，获取方式如下。

API网关协议与地址

当您发送请求调用API时，API网关会校验含有AppSecret的签名。如果校验不通过，则会丢弃请求并返回401错误码。其中，API网关的协议为HTTPS，网关地址如下。

数据中心	Region ID	网关地址
华东2（上海）	cn-shanghai	api.link.aliyun.com
新加坡	ap-southeast-1	ap-southeast-1.api-iot.aliyuncs.com
德国（法兰克福）	eu-central-1	eu-central-1.api-iot.aliyuncs.com
美国（弗吉尼亚）	us-east-1	us-east-1.api-iot.aliyuncs.com

生活物联网平台提供了App端API和云端API，并为您提供了以下语言API的调用SDK或调用示例。

如果您需要使用别的语言来调用API，则需要自行实现该语言的加签逻辑，请参见加签机制。

生活物联网平台提供的所有API都遵循一致的入参规范，其中如下字段为接口调用必须传入的公共字段。

参数	子参数	类型	必有	描述
id	-	String	是	请求ID，如使用生活物联网平台提供的SDK，则会自动生成；如果您自行调用API，则需要自己生成。该参数主要用于关联请求应答及问题定位。
version	-	String	是	开放平台的版本号，当前固定为`1.0`。
request	-	-	是	系统请求参数。
-	apiVer	String	是	所调用接口对应的版本号，具体参见相应的接口文档。
-	iotToken	String	是	该参数仅调用客户端API时生效，主要用于确认请求发起者的系统参数，使用生活物联网平台提供的账号SDK时该值会自动生成。
-	cloudToken	String	是	该参数仅调用云端API时生效，需要您使用项目ID自行获取对应的Token，具体API请参见云端资源服务的获取云端资源token。
-	language	String	否	用于传递多语言信息，该参数仅调用客户端API时生效。
params	-	-	否	业务请求参数，具体内容因不同的接口而不同，部分接口可能不需要入参，仅通过默认的用户鉴权信息即可操作，具体请参见相应的接口文档。

生活物联网平台提供的所有API都遵循一致的出参规范，其中如下字段为接口调用时返回的公共字段。

参数	类型	必有	描述
id	String	是	用于识别请求记录，即对应的请求ID。
code	Int	是	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码，错误码介绍请参见错误码字典。
message	String	是	接口返回信息字段，请求成功返回success；请求失败返回错误原因。
data	-	否	接口返回值字段，每个接口的返回值皆可自定义（部分接口没有返回值，仅通过返回码标识请求成功或失败）。