检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。
API同时支持使用AK/SK认证,AK/SK认证使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口,由于不需要认证,所以
如何调用API 构造请求 认证鉴权 返回结果
对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-token”就是需要获取的用户Token。有了Token之后,您就可以使用Token认证调用其他API。 图1 获取用户Token响应消息头 响应消息体(可选) 该部分可选。响应消息体通常以结构化格式(如JSON或XML)返回
准备工作 注册华为云并实名认证 如果您已有一个华为云账户,请跳到下一个任务。如果您还没有华为云账户,请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/,单击“注册”。 根据提示信息完成注册,详细操作请参见如何注册华为云管理控制台的用户?。
请求示例 DELETE https://mapds.cn-north-4.myhuaweicloud.com/v1/map/credentials/{clientid} 响应示例 无 状态码 状态码 描述 204 删除成功。 400 参数无效。 401 认证失败。 403 没有操作权限。
image/png。 请求示例 GET https://mapds.myhuaweicloud.com/v1/map/tile/{z}/{x}/{y} 响应示例 无 状态码 状态码 描述 200 成功。 202 成功,返回此处无瓦片。 400 参数无效。 401 认证失败。 403 没有操作权限。
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
凭证是识别用户身份的依据,您通过API访问地图瓦片服务时,需要使用凭证来通过系统的鉴权认证。 MapDS控制台凭证操作方式参见管理凭证。 请求获取地图瓦片时,需要在API的Query参数中携带凭证。 请求示例 1 GET https://mapds.myhuaweicloud.com/v1/map/tile/{z}/{x}/{y}
创建SAS Token 功能介绍 创建SAS token凭据,用于访问瓦片。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/map/sastoken
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
调用说明 MapDS服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下,其中projects下的“id”即为项目ID。
管理凭证 操作场景 凭证是您通过开发工具API访问瓦片服务的身份认证,通过“凭证管理”页面您可以创建、删除、查看自己的凭证。 一个用户最多只能创建2个凭证。 如果凭证泄露,可能会导致身份冒用,建议您妥善保存并定期更换。 创建凭证 登录MapDS控制台。 在左侧导航栏选中“凭证管理”,进入“凭证管理”页面。
400 MapDS.10100004 凭证数量超规格。 凭证数量超规格。 请使用已创建的凭证。 401 MapDS.10000002 认证失败。 认证失败。 检查是否有权限。 404 MapDS.10100005 请求资源不存在。 请求资源不存在。 检查请求的参数。 500 MapDS
权限管理 用户需要使用凭证访问地图瓦片。 IAM用户默认可以直接访问地图数据服务,无需授予任何IAM权限。
分配一个凭证给用户。如图2所示。 图2 创建凭证 携带凭证调用API获取地图瓦片,详情参见地图数据API参考。 请求示例 1 GET https://mapds.myhuaweicloud.com/v1/map/tile/{z}/{x}/{y}?key={accessKey}