Add Organization

Last Updated on : 2023-06-15 06:04:07

After entering the organization name, call this API to return the organization ID. You will use the organization ID when you query, modify, delete, and manage the project.

API address

POST: /v1.0/iot-02/community/structure

Request parameter

Description of body

Parameter nameTypeINRequiredDescription
parent_structure_idString falseThe parent organization. An empty value indicates the root organization.
structure_nameString trueThe name of a specified organization.
address_codeString falseAddress (the code of the province, city, district, and street). For more information, visit http://www.stats.gov.cn/english/.
address_detailString falseThe detailed address.
contactString falseThe contact name.
contact_mobileString falseThe contact person's phone number.
contact_emailString falseThe contact person's email address.

Return parameter

Parameter nameTypeDescription
resultStringThe organization ID.

Request example

POST: /v1.0/iot-02/community/structure
{
  "parent_structure_id": "",
  "structure_name": "12121",
  "address_detail": "Room 7x2, Building 3, Zheshang Fortune Center, Xihu District, Hangzhou City, Zhejiang Province",
  "contact": "Helen",
  "contact_mobile": "1880000xxxx",
  "address_code": "110000,110100,110118,110118116,110118116209",
  "location": [
    {
      "level": "1",
      "has_children": true,
      "name": "Beijing City",
      "full_name": "",
      "full_id": "CHN,110000",
      "id": "110000"
    },
    {
      "level": "2",
      "has_children": true,
      "name": "District",
      "full_name": "",
      "full_id": "CHN,110000,110100",
      "id": "110100"
    },
    {
      "level": "3",
      "has_children": true,
      "name": "Miyun District",
      "full_name": "",
      "full_id": "CHN,110000,110100,110118",
      "id": "110118"
    },
    {
      "level": "4",
      "has_children": true,
      "name": "Shicheng Town",
      "full_name": "",
      "full_id": "CHN,110000,110100,110118,110118116",
      "id": "110118116"
    },
    {
      "level": "5",
      "has_children": false,
      "name": "Zhangjiafen Village Committee",
      "full_name": "",
      "full_id": "CHN,110000,110100,110118,110118116,110118116209",
      "id": "110118116209"
    }
  ]
}

Return example

"137209008401233xxxx"

Error code

For more information, see error code.