Endpoints de usuarios (2022/06)

33 min

estos endpoints permiten la gestión de users en una red un user es una instancia de una persona que está asociada con una única red (solo puede haber una persona, pero puede haber de 0 a un número infinito de usuarios en una red) url base para estos endpoints https //api bsn cloud/2022/06/rest/users get / devuelve una lista de users en una red scope token requerido bsn api main users retrieve parámetros de query string marcador \string\ \opcional \ un valor que especifica qué página recuperar este valor es útil si la entrada istruncated del cuerpo de respuesta de la llamada get anterior indica que el número de users excede el pagesize este parámetro solo es requerido si usted necesita más elementos en la lista paginada que el pagesize (100) pagesize \int\ \opcional \ el número máximo de users que pueden estar contenidos en el cuerpo de respuesta de manera predeterminada, este valor es el tamaño máximo de página permitido (100) ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera marcador value se establece en el valor de la propiedad \[pagedlist] \[nextmarker] de la respuesta anterior de la api de bsn cloud pagesize se establece en 1 get /2022/06/rest/users/?marker=ry0jlzw4tww3hcnmsmtcymu4\&pagesize=1 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta exitosa \200\ devuelve una lista paginada docid 1gsmbtulb07tf6mcfqcxp de entidades user docid\ lnibik7fz9mxkikmsure1 en una red esto devolverá no más de 100 entidades junto con la información necesaria para devolver cualquier otra página restante ejemplo { "items" \[ { "id" 12345, "person" { "id" 1234, "login" "johndoe\@look biz", "password" null, "firstname" "john", "lastname" "doe", "creationdate" "2020 07 09t19 05 20 247z", "lastmodifieddate" "2023 11 29t17 40 54 403z", "activationdate" "2020 07 09t19 05 38 723z" }, "description" "network administrator", "creationdate" "2020 07 09t19 09 04 98z", "lastmodifieddate" "2020 08 17t20 49 48 377z", "lastlogindate" "2024 01 03t17 55 26 17z", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 123456, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "johndoe\@look biz", "type" "user", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 48 353z" } ] }], "totalitemcount" 2, "matchingitemcount" 2, "pagesize" 1, "nextmarker" "f32ry0jlzw4tww3hcnmumtcy00", "prevmarker" "f32ry0jlzw4tww3hcnmumt78th", "istruncated" false, "sortexpression" "\[user] \[person] \[login] asc", "filterexpression" "" } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no fue especificado \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post / crea un usuario en una red token de ámbito requerido bsn api main users create cuerpo de la solicitud la entidad de usuario docid\ lnibik7fz9mxkikmsure1 ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera post /2022/06/rest/users/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 468 este es el cuerpo de solicitud de ejemplo { "id" 0, "person" { "id" 0, "login" "johndoe\@host com", "password" null, "firstname" "john", "lastname" "doe", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "activationdate" null }, "description" "supervisor", "creationdate" "0001 01 01t00 00 00", "lastlogindate" null, "islockedout" false, "lastlockoutdate" null, "rolename" "viewers", "permissions" \[] } cuerpo de respuesta exitosa \201\ devuelve la entidad de usuario docid\ lnibik7fz9mxkikmsure1 creada y referenciada por el uri (proporcionado por el campo de encabezado location) en la respuesta ejemplo { "id" 12345, "person" { "id" 12345, "login" "johndoe\@host com", "password" "7t#sqg7 ", "firstname" "john", "lastname" "doe", "creationdate" "2024 01 03t19 05 26 5480648z", "lastmodifieddate" "2024 01 03t19 05 26 5480648z", "activationdate" "2024 01 03t19 05 26 5480648z" }, "description" "supervisor", "creationdate" "2024 01 03t19 05 26 6198305z", "lastmodifieddate" "2024 01 03t19 05 26 9953066z", "lastlogindate" null, "islockedout" false, "lastlockoutdate" null, "rolename" "viewers", "permissions" \[ { "entityid" 30912, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "johndoe\@host com", "type" "user", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2024 01 03t19 05 26 9953066z" } ] } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \415\ el servidor no puede aceptar la representación de datos que usted envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor get /{login}/ devuelve información para un usuario especificado en una red token de ámbito requerido bsn api main users retrieve segmento inicio de sesión \string \ la información de inicio de sesión del user ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en janedoe\@brightsign biz el valor opcional del encabezado if modified since es igual al valor del encabezado última modificación recuperado de la respuesta anterior de get /login o get /id get /2022/06/rest/users/janedoe%40brightsign biz/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad de usuario docid\ lnibik7fz9mxkikmsure1 ejemplo este es un ejemplo de una respuesta correcta de nivel 200 { "id" 123456, "person" { "id" 12345, "login" "janedoe\@brightsign biz", "password" null, "firstname" "jane", "lastname" "doe", "creationdate" "2020 07 09t19 05 20 247z", "lastmodifieddate" "2020 08 17t20 49 48 377z", "activationdate" "2020 07 09t19 05 38 723z" }, "description" "network administrator", "creationdate" "2020 07 09t19 09 04 98z", "lastmodifieddate" "2023 12 20t21 32 35 093z", "lastlogindate" "2024 01 03t19 05 23 98z", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 123456, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 48 353z" } ] } respuesta correcta \304\ el recurso no se modificó desde el momento especificado en el encabezado “if modified since” respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /{login}/ actualiza la información de un user especificado en una red token de alcance requerido bsn api main users update segmento inicio de sesión \string \ la información de inicio de sesión del user cuerpo de la solicitud la entidad de usuario docid\ lnibik7fz9mxkikmsure1 ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en janedoe\@brightsign biz el valor opcional del encabezado if unmodified since es igual al valor del encabezado última modificación recuperado de la respuesta de get /id o get /login put /2022/06/rest/users/janedoe%40brightsign biz/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate if unmodified since wed, 20 dec 2023 21 32 34 gmt content type application/json content length 1440 este es el cuerpo de la solicitud de ejemplo { "id" 123456, "person" { "id" 12345, "login" "janedoe\@brightsign biz", "password" null, "firstname" "jane", "lastname" "doe", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "activationdate" "0001 01 01t00 00 00" }, "description" "network administrator", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "lastlogindate" "0001 01 01t00 00 00", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 123456, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] } respuesta correcta \204\ la información del usuario se ha actualizado respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \412\ error de condición previa (el recurso cambió desde el momento especificado en el valor del encabezado “if unmodified since”) \415\ el servidor no puede aceptar la representación de datos que usted envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{login}/ elimina un usuario especificado en una red token de alcance requerido bsn api main users delete segmento inicio de sesión \string \ la información de inicio de sesión del usuario ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en johndoe\@host com el valor opcional del encabezado if unmodified since es igual al valor del encabezado última modificación recuperado de la respuesta de get /id o get /login delete /2022/06/rest/users/johndoe%40host com/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta \204\ la información del user especificado se eliminó correctamente respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \412\ falló la condición previa (el recurso cambió desde la hora especificada en el valor del encabezado “if unmodified since”) \5xx\ cualquier código 500 es un error interno del servidor get /{id}/ devuelve información para un user especificado en una red token de alcance requerido bsn api main users retrieve segmento id \int \ un identificador único para un user ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 el valor opcional del encabezado if modified since es igual al valor del encabezado última modificación recuperado de la respuesta anterior de get /login o get /id get /2022/06/rest/users/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad user docid\ lnibik7fz9mxkikmsure1 ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "person" { "id" 12345, "login" "janedoe\@brightsign biz", "password" null, "firstname" "jane", "lastname" "doe", "creationdate" "2020 07 09t19 05 20 247z", "lastmodifieddate" "2023 11 29t17 40 54 403z", "activationdate" "2020 07 09t19 05 38 723z" }, "description" "network administrator", "creationdate" "2020 07 09t19 09 04 98z", "lastmodifieddate" "2020 08 17t20 49 48 377z", "lastlogindate" "2024 01 03t19 05 23 98z", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 123456, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 48 353z" } ] } respuesta correcta \304\ el recurso no fue modificado desde el momento especificado en el encabezado “if modified since” respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no fue especificado \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /{id}/ actualice la información del user proporcionado token de scope requerido bsn api main users update segmento id \int \ un identificador único para un user cuerpo de la solicitud el entidad user docid\ lnibik7fz9mxkikmsure1 ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 el valor opcional del encabezado if unmodified since es igual al valor del encabezado última modificación recuperado de la respuesta de get /id o get /login put /2022/06/rest/users/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate if unmodified since wed, 20 dec 2023 21 32 34 gmt content type application/json content length 1440 este es el cuerpo de la solicitud de ejemplo { "id" 12345, "person" { "id" 12345, "login" "janedoe\@brightsign biz", "password" null, "firstname" "jane", "lastname" "doe", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "activationdate" "0001 01 01t00 00 00" }, "description" "network administrator", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "lastlogindate" "0001 01 01t00 00 00", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 123456, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] } respuesta satisfactoria \204\ la información del user ha sido actualizada respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud está mal formado y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \412\ falló la condición previa (el recurso cambió desde el momento especificado en el valor del encabezado “if unmodified since”) \415\ el servidor no puede aceptar la representación de datos que usted envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{id}/ elimina el user especificado en una red token de scope requerido bsn api main users delete segmento id \int \ un identificador único para un user ejemplo de solicitud los parámetros y encabezados de ejemplo de la solicitud se establecen de la siguiente manera id se establece en 12345 el valor opcional del encabezado if unmodified since es igual al valor del encabezado última modificación recuperado de la respuesta de get /id o get /login delete /2022/06/rest/users/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta satisfactoria \204\ la información del user especificado se eliminó correctamente respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud está mal formado y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \412\ falló la condición previa (el recurso cambió desde el momento especificado en el valor del encabezado “if unmodified since”) \5xx\ cualquier código 500 es un error interno del servidor get /operations/ devuelve los permisos operativos otorgados a roles para operaciones de negocio específicas token de alcance requerido bsn api main operations retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera get /2022/06/rest/users/operations/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve la entidad de operaciones de negocio docid\ bb tauffplmvkrodv93i7 ejemplo { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" \[ { "uid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "singularname" "view user", "pluralname" "view users", "fullname" "user (full control) view users", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "1a0c5653 9f2f 4274 f922 f68b17d2d3e7", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "singularname" "create user", "pluralname" "create user", "fullname" "user (full control) create user", "targetentity" "user", "appliance" "collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "1af1f3e0 db38 2bc4 29fb f0f937139d89", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "singularname" "manage notifications", "pluralname" "manage notifications", "fullname" "user (full control) manage notifications", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2023 04 21t19 10 01 36z" }, { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2023 04 21t19 10 01 41z" }, { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "d1d32f0f 39fd 435a bd49 35d76b9abdf2", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" } ] }, { "uid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "singularname" "change role", "pluralname" "change role", "fullname" "user (full control) change role", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "cd9c31e0 d23c 1844 f9f8 dd49ce80e72a", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "singularname" "update user", "pluralname" "update user", "fullname" "user (full control) update user", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "526a9b95 cce5 422a 99f8 9f02d63af74f", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "singularname" "edit permissions", "pluralname" "edit permissions", "fullname" "user (full control) edit permissions", "targetentity" "user", "appliance" "collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "52f1b86c 46df 8fa4 5d75 f0c8702975e6", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "singularname" "revoke tokens", "pluralname" "revoke tokens", "fullname" "user (full control) revoke tokens", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "c244506f 4c57 4f66 88e0 ec2f05d06860", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "singularname" "lock user", "pluralname" "lock user", "fullname" "user (full control) lock user", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "51d92ebc fb22 c4f4 093f a737cba29ea8", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "singularname" "unlock user", "pluralname" "unlock user", "fullname" "user (full control) unlock user", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "3f15e37b 449b 1b24 fd32 d113af0a798a", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] }, { "uid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "singularname" "delete user", "pluralname" "delete user", "fullname" "user (full control) delete user", "targetentity" "user", "appliance" "instance, collection", "parent" { "uid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "singularname" "full control", "pluralname" "user (full control)", "fullname" "user (full control)", "targetentity" "user", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "38b77fd8 16b6 9774 81e4 63af80fbbbb2", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] } ], "permissions" \[ { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2023 04 21t19 10 01 147z" }, { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2023 04 21t19 10 01 16z" }, { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2023 04 21t19 10 01 177z" }, { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2023 04 21t19 10 01 197z" }, { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2023 04 21t19 10 01 357z" }, { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2023 04 21t19 10 01 41z" } ] } respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque es válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{id}/permissions/ incluye permisos de objeto para un usuario determinado token de alcance requerido bsn api main users retrieve segmento id \int \ un identificador único para un usuario ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 get /2022/06/rest/users/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve una matriz de entidades de permiso docid\ hc70cptqcofqdzw2spaek ejemplo \[ { "entityid" 54321, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 48 353z" } ] respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque es válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /{id}/permissions/ agrega permisos para un usuario especificado en una red token de alcance requerido bsn api main users update segmento id \int \ un identificador único para un usuario cuerpo de la solicitud una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12435 post /2022/06/rest/users/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 245 este es el cuerpo de la solicitud de ejemplo \[ { "entityid" 54321, "operationuid" "c978aa8d c7ac 410f aec3 22e136d0ba58", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] respuesta correcta \204\ los permisos se agregaron correctamente al usuario especificado respuesta de error \400\ la solicitud o el cuerpo de la solicitud están mal formados y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \415\ el servidor no puede aceptar la representación de datos que envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{id}/permissions/ elimina permisos para un usuario especificado en una red token de ámbito requerido bsn api main users update segmento id \int \ un identificador único para un usuario cuerpo de la solicitud una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek entidades ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 delete /2022/06/rest/users/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 245 este es el cuerpo de la solicitud de ejemplo \[ { "entityid" 54321, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "login" "janedoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] respuesta correcta \204\ los permisos de user especificados se eliminaron correctamente respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{login}/permissions/ incluye permisos de objetos para un user determinado token de ámbito requerido bsn api main users retrieve segmento inicio de sesión \string \ la información de inicio de sesión del user ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera inicio de sesión se establece en johndoe\@brightsign biz get /2022/06/rest/users/johndoe%40brightsign biz/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek ejemplo \[ { "entityid" 54321, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 48 353z" } ] respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /{login}/permissions/ agrega permisos para un usuario especificado en una red token de scope requerido bsn api main users update segmento inicio de sesión \string \ la información de inicio de sesión del usuario cuerpo de la solicitud un arreglo de entidades permiso docid\ hc70cptqcofqdzw2spaek ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en johndoe\@brightsign biz post /2022/06/rest/users/johndoe%40brightsign biz/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 322 este es el cuerpo de la solicitud de ejemplo \[ { "entityid" 54321, "operationuid" "c978aa8d c7ac 410f aec3 22e136d0ba58", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] respuesta exitosa \204\ los permisos se agregaron correctamente al usuario especificado respuesta de error \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \415\ el servidor no puede aceptar la representación de datos que usted envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{login}/permissions/ elimina permisos para un usuario especificado en una red token de scope requerido bsn api main users update segmento inicio de sesión \string \ la información de inicio de sesión del usuario cuerpo de la solicitud una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera inicio de sesión se establece en johndoe\@brightsign biz delete /2022/06/rest/users/johndoe%40brightsign biz/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 232 este es el cuerpo de la solicitud de ejemplo \[ { "entityid" 54321, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] respuesta correcta \204\ los permisos del user especificado se eliminaron correctamente respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay varias representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{id}/tokens/{token}/ valida el token de acceso o de actualización del usuario otorgado a un user especificado token de scope requerido bsn api main users token validate segmentos id \int \ un identificador único para un user token \string \ un token de acceso o actualización de user para una red bsn cloud ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 token se establece en {{useraccesstoken}} get /2022/06/rest/users/12345/tokens/{{useraccesstoken}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve la entidad de información del token docid\ enpl448 e5z x8x0rqsgt ejemplo { "token" "{{useraccesstoken}}", "scope" "add device setup bsn api main bsn api self bsn api upload bsn ui main player", "validfrom" "2024 01 03t22 57 10z", "validto" "2024 01 03t23 12 10z" } respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor delete /{id}/tokens/{token}/ revoca los tokens de acceso o de actualización del usuario para el usuario especificado token de scope requerido bsn api main users token revoke segmentos id \int \ un identificador único para un usuario token \string \ el token de acceso o de actualización del usuario para usar con esta llamada de endpoint ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 token se establece en {{useraccesstoken}} delete /2022/06/rest/users/12345/tokens/{{useraccesstoken}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa \204\ el token de acceso o de actualización del usuario se ha revocado correctamente del usuario especificado respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el token especificado no es válido, ha expirado o ha sido revocado, o se emitió para otro usuario \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{login}/tokens/{token}/ valida el token de acceso o actualización del usuario otorgado al usuario especificado token de alcance requerido bsn api main users token validate segmentos inicio de sesión \string \ el login de un usuario token \string \ un token de acceso o actualización de usuario para una red bsn cloud ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en johndoe\@brightsign biz token se establece en {{useraccesstoken}} get /2022/06/rest/users/johndoe%40brightsign biz/tokens/{{useraccesstoken}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve la entidad de información del token docid\ enpl448 e5z x8x0rqsgt ejemplo { "token" "{{useraccesstoken}}", "scope" "add device setup bsn api main bsn api self bsn api upload bsn ui main player", "validfrom" "2024 01 03t22 57 10z", "validto" "2024 01 03t23 12 10z" } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y por lo tanto no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor delete /{login}/tokens/{token}/ revoca el token de acceso o actualización del usuario otorgado al usuario especificado token de alcance requerido bsn api main users token revoke segmentos inicio de sesión \string \ el login de un usuario token \string \ un token de acceso o actualización de usuario para una red bsn cloud ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera inicio de sesión se establece en johndoe\@brightsign biz token se establece en {{useraccesstoken}} delete /2022/06/rest/users/johndoe%40brightsign biz/tokens/{{useraccesstoken}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa \204\ el token de acceso o de actualización del usuario se ha revocado correctamente del usuario especificado respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el token especificado no es válido, ha expirado o fue revocado, o fue emitido para otro usuario \406\ el servidor no puede devolver la representación de datos que solicitó (según lo especificado en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor