Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Gestión empresarial/ APIs/ Creación de una empresa como administrador de SP

Actualización más reciente 2023-01-31 GMT+08:00

Ver PDF

Creación de una empresa como administrador de SP

Descripción

Esta API se utiliza para crear una empresa, asignar el administrador de empresa predeterminado y asignar recursos a la empresa como administrador de SP.

Depuración

Puede depurar esta API en Explorador de API.

Prototipo

**Tabla 1** Prototipo
Método de solicitud	POST
Dirección de solicitud	/v1/usg/dcs/sp/corp
Protocolo de transporte	HTTPS

Parámetros de solicitud

**Tabla 2** Parámetros
Parámetro	Obligatorio	Tipo	Localización	Descripción
X-Access-Token	Sí	String	Header	Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación.
X-Request-Id	No	String	Header	ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud.
Accept-Language	No	String	Header	Idioma. Valores zh-CN para el chino (predeterminado) y en-US para el inglés.
adminInfo	Sí	AdminDTO object	Body	Detalles del administrador.
basicInfo	Sí	CorpBasicDTO object	Body	Detalles básicos de empresa
groupId	No	String	Body	ID de grupo de ingestión de medios (incluyendo SBC y MCU), que se puede obtener a través de la API para Consulta de información de recursos como administrador de SP.
propertyInfo	No	Array of OrgPropertyDTO objects	Body	Información sobre elementos configurables.
resInfo	No	AddCorpResDTO object	Body	Detalles de recursos de empresa.

**Tabla 3** Estructura de datos AdminDTO
Parámetro	Obligatorio	Tipo	Localización	Descripción
account	Sí	String	Body	Cuenta de administrador. El valor puede contener letras, números, guiones bajos (_), guiones (-), puntos (.), y signos at (@), y no puede contener solo números. El signo de arroba (@) no puede ir seguido de un punto (.).
country	No	String	Body	País o región a la que pertenece el número de móvil.
email	No	String	Body	Dirección de correo electrónico del administrador. Debe especificarse el número de teléfono móvil o la dirección de correo electrónico del administrador. De lo contrario, la contraseña de administrador no se puede restablecer más tarde. Si la empresa no habilita las notificaciones SMS, la dirección de correo electrónico es obligatoria. El formato es (^$\|^[\w-+]+(\.[\w-+]+)@[\w-]+(\.[\w-]+)(\.[\w-]{1,})$).
name	Sí	String	Body	Nombre del administrador.
phone	No	String	Body	Número móvil. El número de teléfono móvil debe contener el código del país, por ejemplo, un número de teléfono móvil en China continental es el +86xxxxxxxx. Este parámetro se combina con el parámetro country. El número de móvil tiene el formato de (^$\|^[+]?[0-9]+$).
pwd	Sí	String	Body	Si se lleva este parámetro, se utiliza el valor real. De lo contrario, el valor es generado por el backend de forma predeterminada. La contraseña debe cumplir los siguientes requisitos: La contraseña contiene de 6 a 32 caracteres. La contraseña no puede ser la misma que la cuenta o la cuenta escrita al revés. La contraseña debe contener al menos dos de los siguientes: letras minúsculas, letras mayúsculas, números y caracteres especiales (`~!@#$%^&*()-_=+\\|[{}];:,'<.>/?).

**Tabla 4** Estructura de datos CorpBasicDTO
Parámetro	Obligatorio	Tipo	Localización	Descripción
address	No	String	Body	Dirección.
country	No	String	Body	País o región a la que pertenece el número de móvil.
description	No	String	Body	Observaciones.
domain	No	String	Body	Nombre de dominio de empresa.
email	No	String	Body	Dirección de correo electrónico, en el formato de (^$\|^[\w-+]+(.[\w-+]+)@[\w-]+(.[\w-]+)(.[\w-]{1,})$).
fax	No	String	Body	Número de fax, con formato ^$\|^[+]?[0-9]+$.
language	No	String	Body	Lenguaje de voz. Opciones: zh-CN y en-US.
name	Sí	String	Body	Nombre de empresa, con el formato ^[^#%&'+;<>="'??\....../]*$.
phone	No	String	Body	Número móvil. El número de teléfono móvil debe contener el código del país, por ejemplo, un número de teléfono móvil en China continental es el +86xxxxxxxx. Este parámetro se combina con el parámetro country. El número de móvil tiene el formato de (^$\|^[+]?[0-9]+$).
spId	No	String	Body	Este parámetro se devuelve solo durante la consulta.
timeZoneId	No	String	Body	ID de zona horaria. Por ejemplo, el timeZoneId de Pekín GMT+08:00 es de 56. Para ver la asignación entre los IDs de zona horaria y las zonas horarias, consulte Tabla de zonas horarias.

**Tabla 5** estructura de datos de AddCorpResDTO
Parámetro	Obligatorio	Tipo	Localización	Descripción
resource	No	Array of ResourceDTO objects	Body	Lista de recursos que se agregarán a la empresa.

**Tabla 6** estrucura de datos de OrgPropertyDTO
Parámetro	Obligatorio	Tipo	Localización	Descripción
propertyKey	No	String	Body	Clave de elemento de configuración. Para habilitar la grabación local, establezca este parámetro en enableClientRecord.
propertyValue	No	String	Body	Valor del elemento de configuración. Para habilitar la grabación local, establezca este parámetro en true.

**Tabla 7** Estructura de datos ResourceDTO
Parámetro	Obligatorio	Tipo	Localización	Descripción
id	No	String	Body	ID del recurso. Si no se pasa este parámetro, el valor se genera automáticamente.
count	Sí	Integer	Body	Cantidad de recursos.
expireDate	Sí	Long	Body	Hora UTC cuando caduca el recurso.
type	Sí	String	Body	Tipo de recurso. VMR: sala de reuniones en la nube. CONF_CALL: participante simultáneo. HARD_1080P cuenta de acceso a terminal duro de 1080p. HARD_720P cuenta de acceso a terminal duro de 720p. SOFT cuenta de usuario. ROOM cuenta de pizarra. LIVE: puerto de transmisión en vivo. RECORD: espacio de almacenamiento de grabación. HARD_THIRD_PARTY cuenta de acceso al terminal duro de terceros. HUAWEI_VISION cuenta de TV inteligente. IDEA_HUB - ideahub
typeId	No	String	Body	ID de tipo de recurso. Por ejemplo, las salas de reuniones en la nube se pueden dividir en salas de reuniones en la nube de 5 y 10 participantes. En este caso, el tipo de recurso es sala de reuniones en la nube y typeId es vmrPkgId. vmrPkgId se utiliza para distinguir los siguientes subtipos de recursos: vmr10:ff808081699b56d40169c410d5080179 vmr50:ff808081699b56cb0169c411a0980152 vmr100:ff808081699b56cb0169c41167850151 vmr200:ff808081699b56d40169c410913d0178 vmr25:ff808081699b56d40169c4111fe5017a vmr300:ff8080816b9ec3ab016bdff237962e83 vmr400:ff8080816b9ec475016bdff37efc279f vmr500:ff8080816b9ec3ab016bdff338542e84

Códigos de estado

**Tabla 8** Códigos de estado
Código de estado de HTTP	Descripción
200	Operación exitosa.
400	Parámetros no válidos
401	La autenticación no se realiza o falla.
403	Permisos insuficientes.
500	Excepción del servidor.

Parámetros de respuesta

**Tabla 9** Parámetros de respuesta
Parámetro	Tipo	Descripción
value	String	Respuesta.

Solicitud de ejemplo

POST /v1/usg/dcs/sp/corp
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
Content-Type: application/json
Content-Length: 561
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "adminInfo": {
        "account": "zhangsan@corp",
        "country": "chinaPR",
        "email": "zhangsan@huawei.com",
        "name": "zhangsan",
        "phone": "+86191****9092",
        "pwd": "cnp200@HW"
    },
    "basicInfo": {
        "address": "Hangzhou, Zhejiang",
        "country": "chinaPR",
        "description": "description",
        "domain": "huawei.com",
        "email": "zhangsan@huawei.com",
        "fax": "+123456789",
        "language": "zh-CN",
        "name": "Huawei Technologies Co., Ltd.",
        "phone": "+86191****9092",
        "spId": "",
        "timeZoneId": "56"
    },
    "groupId": "297e87ec7713734b01771458c2d80000",
    "resInfo": {
        "resource": [
            {
                "count": 10,
                "expireDate": 2549030400000,
                "id": "36f2c0117cf14c3db61a7880eb73cee6",
                "type": "VMR",
                "typeId": "2c90bb2871e577590171e57bfec908b2"
            }
        ]
    }
}

Ejemplo de respuesta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 21
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 43689056504b4ff22663262d44e141aa

{
  "value": "818803911"
}

Códigos de error

Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en el Centro de errores de la API de Huawei Cloud.

Ejemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' -d '{"account": "zhangsan@corp","country": "chinaPR","email": "zhangsan@huawei.com","name": "zhangsan","phone": "+86191****9092","pwd": "cnp200@HW","sendNotify": false},"basicInfo": {"address": "Hangzhou Zhejiang","country": "chinaPR","description": "description","domain": "huawei.com","email": "zhangsan@huawei.com","fax": "+123456789","language": "zh-CN","name": "Huawei Technologies Co., Ltd.","phone": "+86191****9092","spId": "","timeZoneId": "56"},"groupId": "297e87ec7713734b01771458c2d80000","resInfo": {"resource": [{"count": 10,"expireDate": 2549030400000,"id": "36f2c0117cf14c3db61a7880eb73cee6","type": "VMR","typeId": "2c90bb2871e577590171e57bfec908b2"}]}}' https://api.meeting.huaweicloud.com/v1/usg/dcs/sp/corp

Tema principal: APIs

Tema anterior: Consulta de órdenes de recursos de empresa por página

Tema siguiente: Eliminación de una empresa como administrador de SP