开发 地图小程序OPENAPI 开发指南 企业组织 开放账号

开放帐号 最后更新时间: 2024年08月30日

产品介绍

开放帐号 API 是通过 HTTPS 协议访问远程服务的接口,提供地图小程序用户帐号相关的能力。

适用场景

可以通过某用户的手机号,获取该用户在特定“地图小程序”下的openId,用于后续请求open api 时使用。(比如获取文件夹列表、创建“点资源” 等)

使用限制

详细的服务调用量限制可点我查阅

使用说明

接收请求返回的数据(JSON或XML格式),参考返回参数文档解析数据。

如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。

获取帐号开放数据

请求地址

URL

https://restwia.amap.com/api/v1/wia/account/get?parameters

请求方式

POST

请求类型ContenType

application/x-www-form-urlencoded

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名

含义

规则说明

参数类型

是否必须

缺省值

key

高德Key

用户在高德地图官网申请Web服务API类型Key

string

必填

bizToken

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

string

必填

mobile

手机号

三方用户手机号

string

必填

bizSign

签名值

签名参数:mobile(详见签名规则

string

必填

示例代码 (以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {

  String url = "https://restwia.amap.com/api/v1/wia/account/get";
  Map<String, Object> params = new HashMap<>();
  String mobile = "139****1111";
  params.put("key","在高德开放平台申请的key");
  params.put("bizToken","在高德开放平台申请的bizToken");
  params.put("mobile",mobile);
  String[] signArgs = new String[]{mobile};
  params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
  url = MyHttpUtils.attachParamsToUrl(url, params);

  String response = MyHttpUtils.postFormUrlencoded(url, null);
  System.out.println(response);
}

返回参数

响应结果的格式为 JSON 形式。

以下是返回参数说明:

名称

含义

参数类型

规则说明

code

返回结果状态值

number

见code说明

message

返回状态说明

string

当 status 为 0 时,message 会返回具体错误原因,否则返回“Successful”。详情可以参阅info状态表

timestamp

服务时间戳

number

data

返回结果数据

object

结果对象,包括下述字段:

openId

高德用户对应的开放id

string

此id在相同渠道下唯一

code说明

0、异常

1、成功

2、失败

3、参数错误

100010、biz sign error

100011token not register

100012、查到用户信息失败

100014、计算加密字符错误

100015、计算解密字符错误

110009、user not exist

返回顶部 示例中心 常见问题 智能客服 公众号
二维码