HTTP/HTTPS
请求协议
接口地址：https://api.iot.ink/api/app.php?s=Equipment.Admin_DicCityData_GetfindAllProvinces.Api
接口描述： 获取省份
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| access_token | 字符串 | 可选 | 访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口 | ||
| apiRequestRaw | 字符串 | 可选 | - | ||
| headerInfo | 字符串 | 可选 | - | [] |
返回字段
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象 |
| data.code | 字符串 | |
| data.msg | 字符串 | |
| data.data | 数组 | |
| data.data>>id | 字符串 | |
| data.data>>code | 字符串 | 省code |
| data.data>>parentCode | 字符串 | 父级code |
| data.data>>name | 字符串 | 省名字 |
| data.data>>level | 字符串 | |
| data.data>>telephoneCode | 字符串 | |
| data.data>>nameFirstChar | 字符串 | |
| data.data>>center | 字符串 | |
| data.data>>longitude | 字符串 | |
| data.data>>latitude | 字符串 | |
| data.data>>children | 字符串 | |
| msg | 字符串 | 提示信息，失败时的错误提示 |
在线测试
| 参数 | 是否必须 | 值 |
|---|---|---|
| service | 必须 | |
| access_token | 可选 | |
| apiRequestRaw | 可选 | |
| headerInfo | 可选 |
客户端请求示例
成功响应返回示例：
{
"code": 0,
"msg": null,
"data": [
{
"id": 2,
"code": "410000",
"parentCode": "0",
"name": "河南省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "113.665412,34.757975",
"longitude": "113.665412",
"latitude": "34.757975",
"children": null
},
{
"id": 2690,
"code": "440000",
"parentCode": "0",
"name": "广东省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "g",
"center": "113.280637,23.125178",
"longitude": "113.280637",
"latitude": "23.125178",
"children": null
},
{
"id": 4604,
"code": "150000",
"parentCode": "0",
"name": "内蒙古自治区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "n",
"center": "111.670801,40.818311",
"longitude": "111.670801",
"latitude": "40.818311",
"children": null
},
{
"id": 5948,
"code": "230000",
"parentCode": "0",
"name": "黑龙江省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "126.642464,45.756967",
"longitude": "126.642464",
"latitude": "45.756967",
"children": null
},
{
"id": 7915,
"code": "650000",
"parentCode": "0",
"name": "新疆维吾尔自治区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "x",
"center": "87.617733,43.792818",
"longitude": "87.617733",
"latitude": "43.792818",
"children": null
},
{
"id": 9442,
"code": "420000",
"parentCode": "0",
"name": "湖北省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "114.298572,30.584355",
"longitude": "114.298572",
"latitude": "30.584355",
"children": null
},
{
"id": 11047,
"code": "210000",
"parentCode": "0",
"name": "辽宁省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "l",
"center": "123.429096,41.796767",
"longitude": "123.429096",
"latitude": "41.796767",
"children": null
},
{
"id": 12727,
"code": "370000",
"parentCode": "0",
"name": "山东省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "s",
"center": "117.000923,36.675807",
"longitude": "117.000923",
"latitude": "36.675807",
"children": null
},
{
"id": 14720,
"code": "610000",
"parentCode": "0",
"name": "陕西省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "s",
"center": "108.948024,34.263161",
"longitude": "108.948024",
"latitude": "34.263161",
"children": null
},
{
"id": 16149,
"code": "310000",
"parentCode": "0",
"name": "上海市",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "s",
"center": "121.472644,31.231706",
"longitude": "121.472644",
"latitude": "31.231706",
"children": null
},
{
"id": 16395,
"code": "520000",
"parentCode": "0",
"name": "贵州省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "g",
"center": "106.713478,26.578343",
"longitude": "106.713478",
"latitude": "26.578343",
"children": null
},
{
"id": 17977,
"code": "500000",
"parentCode": "0",
"name": "重庆市",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "z",
"center": "106.504962,29.533155",
"longitude": "106.504962",
"latitude": "29.533155",
"children": null
},
{
"id": 19043,
"code": "540000",
"parentCode": "0",
"name": "西藏自治区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "x",
"center": "91.132212,29.660361",
"longitude": "91.132212",
"latitude": "29.660361",
"children": null
},
{
"id": 19814,
"code": "340000",
"parentCode": "0",
"name": "安徽省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "a",
"center": "117.283042,31.86119",
"longitude": "117.283042",
"latitude": "31.86119",
"children": null
},
{
"id": 21567,
"code": "350000",
"parentCode": "0",
"name": "福建省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "f",
"center": "119.306239,26.075302",
"longitude": "119.306239",
"latitude": "26.075302",
"children": null
},
{
"id": 22845,
"code": "430000",
"parentCode": "0",
"name": "湖南省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "112.982279,28.19409",
"longitude": "112.982279",
"latitude": "28.19409",
"children": null
},
{
"id": 25059,
"code": "460000",
"parentCode": "0",
"name": "海南省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "110.33119,20.031971",
"longitude": "110.33119",
"latitude": "20.031971",
"children": null
},
{
"id": 25384,
"code": "320000",
"parentCode": "0",
"name": "江苏省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "j",
"center": "118.767413,32.041544",
"longitude": "118.767413",
"latitude": "32.041544",
"children": null
},
{
"id": 26925,
"code": "630000",
"parentCode": "0",
"name": "青海省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "q",
"center": "101.778916,36.623178",
"longitude": "101.778916",
"latitude": "36.623178",
"children": null
},
{
"id": 27396,
"code": "450000",
"parentCode": "0",
"name": "广西壮族自治区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "g",
"center": "108.320004,22.82402",
"longitude": "108.320004",
"latitude": "22.82402",
"children": null
},
{
"id": 28804,
"code": "640000",
"parentCode": "0",
"name": "宁夏回族自治区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "n",
"center": "106.278179,38.46637",
"longitude": "106.278179",
"latitude": "38.46637",
"children": null
},
{
"id": 29095,
"code": "360000",
"parentCode": "0",
"name": "江西省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "j",
"center": "115.892151,28.676493",
"longitude": "115.892151",
"latitude": "28.676493",
"children": null
},
{
"id": 30986,
"code": "330000",
"parentCode": "0",
"name": "浙江省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "z",
"center": "120.153576,30.287459",
"longitude": "120.153576",
"latitude": "30.287459",
"children": null
},
{
"id": 32437,
"code": "130000",
"parentCode": "0",
"name": "河北省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "h",
"center": "114.502461,38.045474",
"longitude": "114.502461",
"latitude": "38.045474",
"children": null
},
{
"id": 34926,
"code": "810000",
"parentCode": "0",
"name": "香港特别行政区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "x",
"center": "114.173355,22.320048",
"longitude": "114.173355",
"latitude": "22.320048",
"children": null
},
{
"id": 34945,
"code": "710000",
"parentCode": "0",
"name": "台湾省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "t",
"center": "121.509062,25.044332",
"longitude": "121.509062",
"latitude": "25.044332",
"children": null
},
{
"id": 34946,
"code": "820000",
"parentCode": "0",
"name": "澳门特别行政区",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "a",
"center": "113.54909,22.198951",
"longitude": "113.54909",
"latitude": "22.198951",
"children": null
},
{
"id": 34955,
"code": "620000",
"parentCode": "0",
"name": "甘肃省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "g",
"center": "103.823557,36.058039",
"longitude": "103.823557",
"latitude": "36.058039",
"children": null
},
{
"id": 36473,
"code": "510000",
"parentCode": "0",
"name": "四川省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "s",
"center": "104.065735,30.659462",
"longitude": "104.065735",
"latitude": "30.659462",
"children": null
},
{
"id": 41310,
"code": "220000",
"parentCode": "0",
"name": "吉林省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "j",
"center": "125.3245,43.886841",
"longitude": "125.3245",
"latitude": "43.886841",
"children": null
},
{
"id": 42404,
"code": "120000",
"parentCode": "0",
"name": "天津市",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "t",
"center": "117.190182,39.125596",
"longitude": "117.190182",
"latitude": "39.125596",
"children": null
},
{
"id": 42727,
"code": "530000",
"parentCode": "0",
"name": "云南省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "y",
"center": "102.712251,25.040609",
"longitude": "102.712251",
"latitude": "25.040609",
"children": null
},
{
"id": 44285,
"code": "110000",
"parentCode": "0",
"name": "北京市",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "b",
"center": "116.405285,39.904989",
"longitude": "116.405285",
"latitude": "39.904989",
"children": null
},
{
"id": 44636,
"code": "140000",
"parentCode": "0",
"name": "山西省",
"level": 1,
"telephoneCode": null,
"nameFirstChar": "s",
"center": "112.549248,37.857014",
"longitude": "112.549248",
"latitude": "37.857014",
"children": null
}
]
}
失败响应返回示例：
错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 409 | ret=409，接口流量不足 |
| 500 | 表示服务端内部错误 |
本文档生成时间：2024-05-14 15:19:37