开发 地图小程序OPENAPI 开发指南 开放生态 开放生态账号

开放生态账号 最后更新时间: 2023年07月28日

产品介绍

该 API 是通过 HTTPS 协议访问远程服务的接口,提供生态企业账号相关能力。

使用限制

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

使用说明

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

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

业务身份和业务签名

接口调用要求进行业务身份和签名校验,详情见:业务身份和业务签名 。

1. 企业员工账号登录

请求地址

URL

https://restwia.amap.com/api/v1/wia/ecology/account/login?key=******

请求方式

post/json

业务签名参数

参数名

含义

说明

参数类型

是否必填

缺省值

corpId

企业ID

单独以QueryString形式传递,即作为url参数传递。

string

必填

bizToken

接入方身份token

由高德服务提供

string

必填

请求参数

参数名

含义

说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

放到请求连接后面

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

string

必填

sig

数字签名

放到请求连接后面

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

string

bizSign

业务签名

放到请求连接后面

详见签名规则

string

非必填

appId

接入方应用的唯一标识

类型:String

由高德内部生成

string

必填

corpId

接入方的企业ID

类型:String

不同appId下接入方自行定义

string

必填

thirdPartyId

接入方人员唯一id

类型:String

string

必填

sourceChannel

来源渠道

类型:String

string

必填

返回参数

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

以下是返回参数说明:

参数名

含义

参数类型

说明

code

返回结果状态值

number

0 未知错误;

1 请求成功;

2 请求失败;

3 参数错误;

更多错误码见文档底部

message

返回状态说明

string

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

timestamp

服务器时间戳

number

data

扩展信息

object

备用,根据业务方定制开发。如无特殊要求,可以不解析

openData

类型:String .开放数据

string

携带此数据到高德端内

2.高德账号对应的三方账号换绑

请求地址

URL

https://restwia.amap.com/api/v1/wia/ecology/account/rebindThirdPartyId?key=******

请求方式

post/json

业务签名参数

参数名

含义

说明

参数类型

是否必填

缺省值

corpId

企业ID

单独以QueryString形式传递,即作为url参数传递。

string

必填

bizToken

接入方身份token

由高德服务提供

string

必填

请求参数

参数名

含义

说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

放到请求连接后面

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

string

必填

sig

数字签名

放到请求连接后面

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

string

bizSign

业务签名

放到请求连接后面

详见签名规则

string

非必填

appId

接入方应用的唯一标识

类型:String

由高德内部生成

string

必填

corpId

接入方的企业ID

类型:String

不同appId下接入方自行定义

string

必填

thirdPartyId

接入方人员唯一id

类型:String

string

必填

sourceChannel

来源渠道

类型:String

string

必填

返回参数

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

以下是返回参数说明:

参数名

含义

参数类型

说明

code

返回结果状态值

number

0 未知错误;

1 请求成功;

2 请求失败;

3 参数错误;

更多错误码见文档底部

message

返回状态说明

string

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

timestamp

服务器时间戳

number

data

扩展信息

object

备用,根据业务方定制开发。如无特殊要求,可以不解析

openData

类型:String .开放数据

string

携带此数据到高德端内

3.三方账号对应的高德账号换绑

请求地址

URL

https://restwia.amap.com/api/v1/wia/ecology/account/rebindUid?key=******

请求方式

post/json

业务签名参数

参数名

含义

说明

参数类型

是否必填

缺省值

corpId

企业ID

单独以QueryString形式传递,即作为url参数传递。

string

必填

bizToken

接入方身份token

由高德服务提供

string

必填

请求参数

参数名

含义

说明

参数类型

是否必填

缺省值

key

请求服务权限标识 

放到请求连接后面

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

string

必填

sig

数字签名

放到请求连接后面

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

string

bizSign

业务签名

放到请求连接后面

详见签名规则

string

非必填

appId

接入方应用的唯一标识

类型:String

由高德内部生成

string

必填

corpId

接入方的企业ID

类型:String

不同appId下接入方自行定义

string

必填

thirdPartyId

接入方人员唯一id

类型:String

string

必填

sourceChannel

来源渠道

类型:String

string

必填

返回参数

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

以下是返回参数说明:

参数名

含义

参数类型

说明

code

返回结果状态值

number

0 未知错误;

1 请求成功;

2 请求失败;

3 参数错误;

更多错误码见文档底部

message

返回状态说明

string

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

timestamp

服务器时间戳

number

data

扩展信息

object

备用,根据业务方定制开发。如无特殊要求,可以不解析

openData

类型:String .开放数据

string

携带此数据到高德端内

错误码说明

code值

说明

1

请求成功

0

未知错误

2

请求失败

3

参数错误

4

限流

100010

业务签名错误

100011

token not register

100012

查到用户信息失败

100014

计算加密字符错误

150001

三方手机号对应的高德账号已有绑定关系

150002

三方账号绑定的高德账号没有手机号

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