概述 | 星舆科技-云顶国际yd888

# 概述

高精度感知服务向开发者提供 https api，开发者可通过 https 请求使用相关高精度感知服务功能。具体可查看api文档 (opens new window)。

# 服务地址

服务地址：https://openapi.starcart.cn/pro/v1，支持 https，以 post 或 get 方式进行请求，返回结果为 json 数据格式。

# 请求返回值

请求返回值为一个 json 对象，格式如下：

{
    "code": xxx,
    "result": [{xxxx}],
    "msg": "xxx"
}

1
2
3
4
5

名称	描述	值
code	状态码	1000，调用成功，调用结果符合预期。非1000，调用失败，调用结果不符合预期。
result	返回数据	当code为1000时，result 不为空，是调用结果的 json 格式数据。当 code 不为1000时，则 result 为 null。
msg	状态信息描述	对调用结果 code 的文字说明。

# 状态码

code	msg	说明
1003	missing param	缺失参数
1004	invalid param	无效参数

# api说明

以下以感知服务接口示例

1. 获取全局唯一接口访问令牌

通过凭证和凭证秘钥获取全局唯一接口访问令牌：（1）token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的token在5分钟后失效，以保证第三方业务的平滑过渡；（2）该接口日调用次数最多为1000次

• 请求地址：token/get

• 请求方式：get

• 请求参数：

参数名	类型	必填	描述	默认值
key	string	是	第三方用户唯一凭证	--
secret	string	是	第三方用户唯一凭证密钥	--

• 返回正确显示示例：

{
    "code": 1000,
    "result": {
        "token": "eljrbgtvy05vn1vmvfbsukp0zzfwnjdhdfroufpktuwrclzsexditupgru01sstez0fibmhkk29td0
                  nmuudlefdewljin0j4z05zcxpnnxvmzkrxr3hvbe8zymnrchpms3jqqwp0vwt4cvjpwvark1p4bglm
                  sw9uwdg1cfbeztbccxk4agzjunnnyxjha0vtsejiqu10bxbrem10vctym25nsernystjbupnpq",
        "expires": 7200
    },
    "msg": "success"
    }
}

1
2
3
4
5
6
7
8
9
10
11

• 返回错误结果示例：

{
    "code": 1004,
    "msg": "invalid param"
}

1
2
3
4

• 返回参数说明:

参数名	类型	说明
token	string	访问令牌
expires	long	有效期，单位：秒

• 状态码：

code	msg	说明
1000	success	成功
1003	missing param	参数缺失
1004	invalid param	无效参数
1005	invalid request version	无效的请求
1008	server busy	服务器繁忙
1009	failed	服务异常
1010	access exceeded	访问次数超限（日限1000）
8003	key does not match secret	key和secret不匹配

2. 查询应用下毫米级指定监测站点信息

通过访问令牌和站点编码查询应用下毫米级指定监测站点信息

• 请求地址：mmstation/query