ASTRO轻应用 ASTROZERO-构造请求:请求消息头

时间:2024-07-01 09:06:42

请求消息头

附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。

详细的公共请求消息头字段请参见表3
表3 公共请求消息头

消息头名称

描述

是否必选

Content-Type

HTTP协议中设定的一个参数,用于标识返回的内容用什么格式去解析。

  • 配置为“application/json”。表示浏览器将返回内容解析为json对象。
  • 配置为“application/x-www-form-urlencoded”,表示urlencode格式。

tenant-id

账号的标识,不能重复,用于定义哪个账号接收请求。

access-token

access-token是调用AstroZero接口API要用到的访问令牌,在调用API的时候将access-token加到请求消息头,从而通过身份认证,获得操作API的权限。

当AstroZero的用户和业务用户通过账号密码登录AstroZero后,后台会生成一个访问令牌,在响应消息中携带,并存在浏览器中。下次再调用请求后,会带上这个访问令牌,表示这个用户已经被鉴权过。当第三方系统要访问AstroZero的业务接口时,需要提前使用OAuth协议进行接入认证,获取客户端鉴权ID(Client ID)和客户端鉴权密钥(Client Secret),再使用客户端鉴权ID和客户端鉴权密钥调用接口“/baas/auth/v1.0/oauth2/token”获取access_token,从而获取AstroZero业务接口的访问令牌。

使用access-token认证时该字段必选。

对于使用OAuth 2.0的客户端鉴权模式,获取用户access_token接口,由于不需要access-token认证,所以只添加“Content-Type”为“application/x-www-form-urlencoded”即可,添加消息头后的请求如下所示。

POST https://appcube.cn-north-4.huaweicloud.com/baas/auth/v1.0/oauth2/token 
Content-Type: application/x-www-form-urlencoded
support.huaweicloud.com/api-astrozero/astrozero_api_0009.html