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

账号同步接口 最后更新时间: 2024年05月14日

账号同步

请求地址:

URL

https://restwia.amap.com/api/v1/wia/account/sync

请求方式

POST

ContenType

application/json

url 请求参数

参数名

参数类型

含义

规则

示例值

是否必填

key

String

高德Key

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

必填

bizToken

String

工作地图身份token

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

必填

sig

String

数字签名

请参考数字签名获取和使用方法

选填

bizSign

String

业务签名

签名参数 bizToken参考签名规则

必填

body请求参数

参数名

参数类型

含义

规则

示例值

是否必填

mobile

String

司机手机号

必填

workMapId

String

工作地图id

非必填

createSecondSource

String

渠道编码

高德提供

必填

corpName

String

 公司名称

人员属于的公司名称

非必填

corpId

String

 公司 Id

人员属于的公司Id

非必填

示例代码(以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/sync";
    Map<String, Object> params = new HashMap<>();
    String bizToken = "在高德开放平台申请的bizToken";

    params.put("key", "在高德开放平台申请的key");
    params.put("openId", "当前操作用户的openId");
    params.put("bizToken", bizToken);
    String[] signArgs = new String[]{bizToken};
    params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));

    // 示例:"{\"mobile\": \"1835867****\",\"workMapId\" : \"o2Z0BP-IMStITnTy3_qESg\",\"createSecondSource\": \"40000***\"}"
    String jsonBodyStr = "body参数";

    url = MyHttpUtils.attachParamsToUrl(url, params);

    String response = MyHttpUtils.postApplicationJson(url, jsonBodyStr);
    System.out.println(response);

}

返回参数

响应结果的格式为 JSON 形式,以下是参数说明

参数名

含义

参数类型

规则说明

data

返回结果数据

Object

driverOpenId

司机的openId

String

masterOpenId

管理员openId

String

orgId

企业id

String

workMapId

workMapId

String

code

返回结果状态值

Number

message

返回状态说明

String

成功时返回Successful,否则返回错误原因

result

结果

Boolean

true或false

version

版本信息

String

timestamp

时间戳

Number

requestId

请求id

String

返回示例

{
    "data": {
      "driverOpenId":"123123123",
      "masterOpenId":"31231",
      "orgId":"31231",
      "workMapId":"31231",
    },
    "code": 1,
    "message": "Successful",
    "result": true,
    "version": "1.0",
    "timestamp": 1701142286019,
    "requestId": "1eb5d12017011422856761177d14ca"
}
返回顶部 示例中心 常见问题 智能客服 公众号
二维码