Get Structure by App¶

Get the organization structure root node assigned to an application.

Request Format¶

GET https://{apigw-address}/app-portal-service/v2.3/structure-service/structures/app

Request Parameters (Header)¶

Name

Mandatory/Optional

Data Type

Description

locale

Optional

String

Language code. Enligh as default

en_US for English

zh_CN for Simplified Chinese

es_ES for Spanish

ja_JP for Japanese

authorization

Optional

String

User access token. If not empty, return the visible organization structures of the user in the application

Request Parameters (URI)¶

Name	Mandatory/Optional	Data Type	Description
appId	Mandatory	String	Application ID
orgId	Mandatory	String	OU ID

Response Parameters¶

Name	Data Type	Description
data	StructureDTO Struct	Organization structure information

StructureDTO Struct¶

Name	Data Type	Description
id	String	Organization structure ID.
parentId	String	Parent node ID
name	String	Organization structure name
description	String	Organization structure description
displayOrder	Integer	Sort number
tags	Object	tags

Error Codes¶

Error Code	Description
31520	The OU does not purchase the application

Samples¶

Request Sample¶

url: https://{apigw-address}/app-portal-service/v2.3/structure-service/structures/app

method: GET

Return Sample¶

{
    "code": 0,
    "data": [
        {
            "name": "name1",
            "displayOrder": 0,
            "description": "",
            "id": "sgxxxxxxxxxxx",
            "parentId": "",
            "tags": {
                "key1": "value1"
            }
        }
    ],
    "message": "OK"
}