根据单位ID获取单位详情

接口描述:

根据单位ID获取单位详情

接口地址:

  • https://api_server_url/unit/info

请求方式:

  • GET

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
accessToken 接口访问凭证 query true string
unitId 单位ID query true integer(int64)

响应状态

状态码 说明 schema
200 OK ApiRestResponse«UnitInfoVO»
401 Unauthorized
403 Forbidden
404 Not Found

其他状态码参见:全局状态码

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": {
        "id": "1599695560903458818",
        "orgId": "1599695561170583553",
        "dwdm": "10010001",
        "dwmc": "单位一",
        "dwywmc": "",
        "dwdz": "14564444444444444",
        "dwyzbm": "",
        "dwzgbmm": "",
        "dwjj": "",
        "tyshxydm": "14564444444444444",
        "xzqhm": ""
    }
}

错误时返回:

{
    "code": 500,
    "data": {},
    "message": "成功或异常消息",
    "status": "fail"
}

响应参数:

参数名称 参数说明 类型 schema
code 成功或异常编码 integer(int32) integer(int32)
data 成功或异常数据 UnitInfoVO UnitInfoVO
message 成功或异常消息 string
status 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error string
Schema 属性:

UnitInfoVO

参数名称 参数说明 类型 schema
id 学校基本数据子类表ID integer(int64)
orgId 学校的组织机构id integer(int64)
dwdm 单位代码 string
dwdz 单位地址 string
dwjj 单位简介 string
dwmc 单位名称 string
dwywmc 单位英文名称 string
dwyzbm 单位邮政编码 string
dwzgbmm 单位主管部门码 string
tyshxydm 统一社会信用代码 string
xzqhm 行政区划码 string

调用示例:

NodeJs - Axios:

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api_server_url/unit/info?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&unitId=123',
  headers: {
    'X-App-Id': '1'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Java - OkHttp 示例:

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api_server_url/unit/info?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&unitId=123")
  .method("GET", null)
  .addHeader("X-App-Id", "1")
  .build();
Response response = client.newCall(request).execute();
作者:杭州天音  创建时间:2022-12-20 13:59
最后编辑:杭州天音  更新时间:2025-08-22 15:44