Endpoints propios (2022/06)

91 min

estos endpoints permiten a los usuarios administrar su configuración en la red actual url base para estos endpoints https //api bsn cloud/2022/06/rest get /self/ devuelve su información de entidad person docid\ puejlhyw0s15hwhvxwcif token de alcance requerido bsn api self info retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera el valor opcional del encabezado if modified since es igual al valor del encabezado última modificación recuperado de la respuesta de get /self/ get /2022/06/rest/self/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate if modified since wed, 29 nov 2023 17 40 51 gmt respuesta exitosa con cuerpo \200\ devuelve la entidad person docid\ puejlhyw0s15hwhvxwcif ejemplo este es un ejemplo de una respuesta de nivel 200 { "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" } respuesta exitosa \304\ el recurso no fue modificado desde la hora especificada 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) \4\ \00\ la solicitud está mal formada y por lo tanto es inválida \401\ el token de acceso es invá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ó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /self/ registra a la persona y devuelve sus credenciales de persona (excepto la contraseña si fue proporcionada en su solicitud) token de alcance requerido ninguno cuerpo de la solicitud la entidad person docid\ puejlhyw0s15hwhvxwcif si especifica una contraseña que coincida con nuestra política de seguridad, el servidor aplicará la contraseña que especifique y no devolverá una contraseña si no especifica una contraseña, el servidor generará una contraseña y se la devolverá ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera post /2022/06/rest/self/ http/1 1 host api bsn cloud connection keep alive accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 309 este es el cuerpo de la solicitud de ejemplo { "id" 0, "login" "janedoe\@gmail com", "password" null, "firstname" "jane", "lastname" "doe", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "activationdate" "0001 01 01t00 00 00" } cuerpo de respuesta exitosa \200\ devuelve la entidad de persona docid\ puejlhyw0s15hwhvxwcif ejemplo { "id" 12345, "login" "janedoe\@gmail com", "password" "7t#sqg7 ", "firstname" "jane", "lastname" "doe", "creationdate" "2023 12 01t16 47 03 3893279z", "lastmodifieddate" "2023 12 01t16 47 03 3893279z", "activationdate" null } 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 empresariales \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 solicitó (según se especifica en el encabezado "accept") \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 \ cualquier código 500 es un error interno del servidor\ get /self/profile/ devuelve un perfil de persona completo token de alcance requerido bsn api self profile retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera get /2022/06/rest/self/profile/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa con cuerpo \200\ el tipo de retorno es un objeto, donde los nombres de las propiedades son claves de perfil y los valores del perfil son los valores de esas propiedades ejemplo { "personaccesstokenlifetime" "00 15 00", "personrefreshtokenlifetime" "1 00 00 00" } respuesta de error \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 \5xx\ cualquier código 500 es un error interno del servidor post /self/profile/ crea una nueva propiedad de perfil para una persona token de alcance requerido bsn api self profile update cuerpo de la solicitud par \\<string, string\> \ un par clave valor de la propiedad de perfil de la persona ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera post /2022/06/rest/self/profile/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 44 este es el cuerpo de la solicitud de ejemplo { 	"key" "newproperty1", 	"value" "111" } cuerpo de la respuesta de éxito \201\ devuelve el nuevo recurso creado y referenciado por el uri (proporcionado por el campo de encabezado location) en la respuesta devuelve un objeto donde los nombres de las propiedades corresponden a las claves del perfil y los valores de las propiedades corresponden a los nombres del perfil ejemplo { "key" "newproperty1", "value" "111" } 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 la clave de la propiedad de perfil especificada está reservada o supera los 62 caracteres \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ó (como se especifica en el encabezado "accept") \409\ la propiedad de perfil de la persona con la clave especificada ya existe \413\ la longitud del valor especificado de la propiedad de perfil de la persona excede el límite de 64kb \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 get /self/profile/{key}/ devuelve un valor de propiedad de perfil para una persona token de alcance requerido bsn api self profile retrieve segmento clave \string \ el nombre de la propiedad de perfil ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera clave se establece en personaccesstokenlifetime get /2022/06/rest/self/profile/personaccesstokenlifetime/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve un valor de propiedad de perfil ejemplo este es un ejemplo de una respuesta de nivel 200 "00 15 00" respuesta exitosa \304\ el recurso no fue modificado desde la hora especificada 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 está mal formada y, por lo tanto, es inválida \401\ el token de acceso es invá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 solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /self/profile/{key}/ crea o actualiza un valor de propiedad de perfil de persona token de alcance requerido bsn api self profile update segmento clave \string \ el nombre de la propiedad de perfil cuerpo de la solicitud \string \ el valor de la propiedad de perfil que se va a actualizar ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera clave se establece en personrefreshtokenlifetime put /2022/06/rest/self/profile/personrefreshtokenlifetime/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 12 este es el cuerpo de la solicitud de ejemplo "1 00 00 00" respuesta exitosa \201\ devuelve este código de estado si el valor de la propiedad de persona se define por primera vez \204\ devuelve este código de estado si el valor de la propiedad de persona ya existe y ha sido 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 está mal formado y, por lo tanto, es inválido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no fue especificado \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 usted solicitó (según se especifica en el encabezado "accept") \412\ la condición previa falló (el recurso cambió desde el momento especificado en el valor del encabezado “if unmodified since”) \413\ la longitud de la propiedad del perfil de usuario especificada supera el límite de 64kb \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 delete /self/profile/{key}/ elimina una propiedad de perfil de una persona token de scope requerido bsn api self profile update segmento clave \string \ el nombre de la propiedad del perfil ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera clave se establece en newproperty1 delete /2022/06/rest/self/profile/newproperty1/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta satisfactoria \204\ la propiedad del perfil ha sido eliminada respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, es inválida, o se rechaza 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 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 usted solicitó (según se especifica en el encabezado "accept") \412\ la condición previa falló (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 /self/session/ recupera el conjunto completo de atributos definidos en el contexto de la sesión de la persona actual ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera el valor opcional del encabezado if modified since es igual al valor del encabezado última modificación recuperado de la respuesta anterior de get /self/session/ get /2022/06/rest/self/session/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{accesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate if modified since wed, 29 nov 2023 17 40 51 gmt respuesta correcta con cuerpo \200\ devuelve la estructura del contexto de sesión docid\ oqcmaac7dypomevxk7joe ejemplo { "network" { "id" 12345, "name" "johndoe" }, "authorizationscope" "bsn api main bsn api self bsn api upload bsn ui main player", "lastmodifieddate" "2024 08 08t16 10 13 673z" } \304\ el valor del encabezado http if modified since proporcionado coincide con la marca de tiempo de la asignación del valor del atributo actual respuesta de error \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso de persona proporcionado no es válido y no se puede recuperar el id de sesión \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \410\ el token de acceso de persona proporcionado es válido, pero la sesión con el id resuelto ha sido invalidada \5xx\ cualquier código 500 es un error interno del servidor get /self/session/network/ recupera los identificadores de la red en la que ha iniciado sesión el usuario actual ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera get /2022/06/rest/self/session/network/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{accesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve el valor del atributo solicitado, que es network info entity o null si la persona actual no ha iniciado sesión en ninguna red ejemplo { "id" 12345, "name" "johndoe" } \204\ la solicitud se ejecutó correctamente, pero no hay contenido para devolver (la red no está configurada en el contexto de la sesión actual) respuesta de error \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso de persona proporcionado no es válido y no se puede recuperar el id de sesión \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \410\ el token de acceso de persona proporcionado es válido, pero la sesión con el id resuelto ha sido invalidada \5xx\ cualquier código 500 es un error interno del servidor put /self/session/network/ permite que una persona establezca o cambie una red en la que la persona ha iniciado sesión dentro del alcance de la sesión actual ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera put /2022/06/rest/self/session/network/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{accesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 40 este es el cuerpo de la solicitud de ejemplo { "id" 12345, "name" "janedoe" } respuesta correcta con cuerpo \204\ la persona inició sesión correctamente en la red especificada respuesta de error \400\ solicitud no válida y cualquiera de las siguientes infracciones de reglas de negocio la entidad de información de red docid 374tldck1wlknfx0p9kmw proporcionada tiene un formato no válido no se especifica ni el id de red ni el nombre de red en la solicitud no existe una red con el id o nombre especificado una red con el id o nombre especificado está suspendida la persona propietaria del token de acceso proporcionado no es miembro de la red con el id o nombre especificado la persona en la red con el id o nombre especificado está deshabilitada \401\ el token de acceso de persona proporcionado no es válido y no se puede recuperar el id de sesión \410\ el token de acceso de persona proporcionado es válido, pero la sesión con el id resuelto ha sido invalidada \5xx\ cualquier código 500 es un error interno del servidor get /self/session/authorizationscope/ recupera el alcance de las acciones que el usuario actual está autorizado a realizar con el token de acceso proporcionado ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera get /2022/06/rest/self/session/authorizationscope/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{accesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la lista separada por espacios de tokens que representan los recursos disponibles ejemplo "bsn api main bsn api self bsn api upload bsn ui main player" respuesta de error \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso de persona proporcionado no es válido y no se puede recuperar el id de sesión \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \410\ el token de acceso de persona proporcionado es válido, pero la sesión con el id resuelto ha sido invalidada \5xx\ cualquier código 500 es un error interno del servidor put /self/session/authorizationscope/ permite que una persona cambie la lista de recursos a los que está autorizada a acceder con el token de acceso proporcionado ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera put /2022/06/rest/self/session/authorizationscope/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{accesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 40 este es el cuerpo de la solicitud de ejemplo "bsn api main bsn api self bsn api upload bsn ui main player" respuesta correcta \204\ el ámbito de autorización se ha actualizado correctamente respuesta de error \400\ solicitud no válida y cualquiera de las siguientes infracciones de reglas de negocio el ámbito de autorización proporcionado tiene un formato no válido uno o más tokens de ámbito especificados no están disponibles con el token proporcionado \401\ el token de acceso de persona proporcionado no es válido y no se puede recuperar el id de sesión \410\ el token de acceso de persona proporcionado es válido, pero la sesión con el id resuelto ha sido invalidada \5xx\ cualquier código 500 es un error interno del servidor get /self/tokens/{token}/ obtiene el estado del token de acceso o de actualización oauth2 de persona especificado token de ámbito requerido bsn api self token validate segmento token \string \ un token de acceso o actualización de persona ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera token se establece en {{token}} get /2022/06/rest/self/tokens/{{token}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta correcta \200\ devuelve la entidad de información de token docid\ enpl448 e5z x8x0rqsgt ejemplo { "token" {{token}}, "scope" "bsn api self", "validfrom" "2023 11 29t17 43 55z", "validto" "2023 11 29t17 58 55z" } respuesta de error \300\ la representación solicitada no se pudo devolver 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 ha especificado \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el token de acceso o de actualización de persona especificado ha expirado, ha sido revocado o no es válido \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 /self/tokens/{token}/ revoca un token de acceso o refresh de una persona token de scope requerido bsn api self token revoke segmento token \string \ un token de acceso o refresh de una persona ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera token se establece en {{token}} delete /2022/06/rest/self/tokens/{{token}}/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa \204\ el token de acceso o refresh de la persona ha sido eliminado 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án mal formados y, por lo tanto, son inválidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no fue especificado \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ la persona especificada o el token de refresh de acceso ha expirado, ha sido revocado o es inválido \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 get /self/networks/ devuelve las redes asociadas con una persona token de scope requerido bsn api self networks retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera get /2022/06/rest/self/networks/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta exitosa \200\ devuelve un array de entidad de red docid 2jrecadwf kzjindv6m03 instancias de las que la persona actual es miembro ejemplo \[ { "id" 12345, "name" "controlcloud network1", "creationdate" "2020 07 14t18 40 58 087z", "lastmodifieddate" "2020 07 14t18 40 58 087z", "lockoutdate" null, "islockedout" false, "lastlockoutdate" null, "settings" { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2020 07 14t18 41 00 613z" }, "subscription" { "id" 12345, "level" "control", "creationdate" "2020 07 14t18 40 58 783z", "lastmodifieddate" "2020 07 14t18 40 58 783z", "expiredate" null } } ] respuesta de error \300\ la representación solicitada no pudo devolverse 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 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 post /self/networks/ crea una red para la persona token de scope requerido bsn api self networks create cuerpo de la solicitud la entidad de red docid 2jrecadwf kzjindv6m03 ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera post /2022/06/rest/self/networks/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 581 este es el cuerpo de la solicitud de ejemplo { "id" 0, "name" "testdisplay", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "lockoutdate" null, "islockedout" false, "lastlockoutdate" null, "settings" { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "0001 01 01t00 00 00" }, "subscription" null } cuerpo de la respuesta exitosa \201\ devuelve el nuevo recurso creado y referenciado por el uri (proporcionado por el campo de encabezado location) en la respuesta la respuesta incluye la entidad de red (consulte entidad de red docid 2jrecadwf kzjindv6m03 ) ejemplo { "id" 12345, "name" "testdisplay", "creationdate" "2023 12 07t18 29 58 5041056z", "lastmodifieddate" "2023 12 07t18 29 58 5041056z", "lockoutdate" null, "islockedout" false, "lastlockoutdate" null, "settings" { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2023 12 07t18 29 58 5041056z" }, "subscription" { "id" 12345, "level" "control", "creationdate" "2023 12 07t18 29 58 5142438z", "lastmodifieddate" "2023 12 07t18 29 58 5142438z", "expiredate" null } } 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á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 \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \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 get /self/networks/{id}/ obtiene una red asociada con un id especificado scope token requerido bsn api self networks retrieve segmento id \int \ el identificador único de una red 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/self/networks/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa con cuerpo \200\ devuelve la entidad de red docid 2jrecadwf kzjindv6m03 ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "name" "janedoetesting", "creationdate" "2020 07 09t19 09 04 937z", "lastmodifieddate" "2020 07 09t19 09 04 937z", "lockoutdate" null, "islockedout" false, "lastlockoutdate" null, "settings" { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2020 07 09t19 09 06 77z" }, "subscription" { "id" 12345, "level" "content", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" } } respuesta exitosa \304\ el recurso no fue modificado desde la hora especificada 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 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 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 patch /self/networks/{networkid}/ aplica cambios a una red asociada con un id especificado scope token requerido bsn api self networks update segmento networkid \int \ el identificador único de una red cuerpo de la solicitud estas propiedades son entradas en un arreglo cada entrada debe tener las tres propiedades siguientes op \string\ el tipo de operación; en este caso siempre es "replace" ruta \string\ una ruta uri que hace referencia a la ubicación dentro del documento de destino donde se realizará la actualización valor \object\ el/los valor(es) de reemplazo para los parámetros que deben actualizarse esto puede ser un arreglo ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera networkid se establece en 12345 patch /2022/06/rest/self/networks/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 content type application/json patch+json content length 94 este es el cuerpo de la solicitud de ejemplo \[ { "op" "replace", "path" "/subscription/level/", "value" "trial" } ] respuesta correcta \204\ los parámetros se han reemplazado correctamente 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) \412\ condición previa fallida (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 get /self/networks/{name}/ devuelve una red asociada con un nombre especificado token de alcance requerido bsn api self networks retrieve segmento nombre \string \ el nombre de una red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en janedoetesting get /2022/06/rest/self/networks/janedoetesting/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve la entidad de red docid 2jrecadwf kzjindv6m03 ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "name" "janedoetesting", "creationdate" "2020 07 09t19 09 04 937z", "lastmodifieddate" "2020 07 09t19 09 04 937z", "lockoutdate" null, "islockedout" false, "lastlockoutdate" null, "settings" { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "30 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2023 12 07t21 41 44 01z" }, "subscription" { "id" 12345, "level" "content", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" } } respuesta correcta \304\ el recurso no se modificó desde la hora especificada en el encabezado “if modified since” 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 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ó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor patch /self/networks/{networkname}/ aplica cambios a una red asociada con un id especificado token de alcance requerido bsn api self networks update segmento networkname \string \ el nombre de la red cuerpo de la solicitud estas propiedades son entradas en un array cada entrada debe tener estas tres propiedades op \string\ el tipo de operación; en este caso siempre es "replace" ruta \string\ una ruta uri que hace referencia a la ubicación dentro del documento de destino donde se realizará la actualización valor \object\ los valores de reemplazo para los parámetros que deben actualizarse esto puede ser un array ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera networkname se establece en janedoetesting patch /2022/06/rest/self/networks/janedoetesting/ 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 patch+json content length 94 este es el cuerpo de la solicitud de ejemplo \[ { "op" "replace", "path" "/subscription/level/", "value" "trial" } ] respuesta correcta \204\ los parámetros se reemplazaron correctamente respuesta de error \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) \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 envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor get /self/networks/{id}/settings/ devuelve la configuración asociada con una red especificada token de ámbito requerido bsn api self networks retrieve segmento id \int \ el identificador único de una red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 get /2022/06/rest/self/networks/12345/settings/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad de configuración de red docid\ nk0dwpolmyyb3spn9rk3r ejemplo este es un ejemplo de una respuesta de nivel 200 { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2020 07 09t19 09 06 77z" } 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 /self/networks/{id}/settings/ actualiza la configuración asociada con una red especificada token de scope requerido bsn api self networks update segmento id \int \ el identificador único de una red cuerpo de la solicitud la entidad de configuración de red docid\ nk0dwpolmyyb3spn9rk3r ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 put /2022/06/rest/self/networks/12345/settings/ 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 335 este es el cuerpo de solicitud de ejemplo { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "30 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "0001 01 01t00 00 00" } respuesta correcta \204\ la configuración especificada se ha actualizado en la red 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 tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas comerciales \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") \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 get /self/networks/{name}/settings/ obtiene la configuración asociada con una red especificada token de scope requerido bsn api self networks retrieve segmento nombre \string \ el nombre de la red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en janedoetesting get /2022/06/rest/self/networks/janedoetesting/settings/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta exitosa \200\ devuelve la entidad de configuración de red docid\ nk0dwpolmyyb3spn9rk3r ejemplo { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "1 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "2020 07 09t19 09 06 77z" } 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 /self/networks/{name}/settings/ actualiza la configuración asociada con una red especificada token de scope requerido bsn api self networks update segmento nombre \string \ el nombre de la red cuerpo de la solicitud la entidad de configuración de red docid\ nk0dwpolmyyb3spn9rk3r ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera nombre se establece en janedoetesting put /2022/06/rest/self/networks/janedoetesting/settings/ 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 335 este es el cuerpo de la solicitud de ejemplo { "useraccesstokenlifetime" "00 15 00", "userrefreshtokenlifetime" "30 00 00 00", "deviceaccesstokenlifetime" "00 15 00", "devicerefreshtokenlifetime" "730 00 00 00", "deviceregistrationtokenlifetime" "730 00 00 00", "automatictaggedplaylistapprovalenabled" false, "lastmodifieddate" "0001 01 01t00 00 00" } respuesta correcta \204\ la configuración de red 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 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 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ó (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 /self/networks/{id}/subscription/ devuelve la información de suscripción actual asociada con una red especificada token de scope requerido bsn api self networks retrieve segmento id \int \ el identificador único de una red 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/self/networks/12345/subscription/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad de suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "level" "content", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" } 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 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ó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /self/networks/{id}/subscription/ actualiza la información de suscripción actual asociada con una red especificada un usuario regular solo puede usar esto para habilitar un período de prueba de content cloud (si no se habilitó previamente) token de scope requerido bsn api self networks update segmento id \int \ el identificador único de una red cuerpo de la solicitud la entidad de suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 put /2022/06/rest/self/networks/12345/subscription/ 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 114 este es el cuerpo de solicitud de ejemplo { "id" 0, "level" "trial", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "expiredate" null } respuesta exitosa \204\ la información de suscripción se actualizó 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 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ó (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 envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor get /self/networks/{name}/subscription/ devuelve la información de suscripción actual asociada con una red especificada alcance requerido bsn api self networks retrieve segmento nombre \string \ el nombre de la red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en janedoetesting get /2022/06/rest/self/networks/janedoetesting/subscription/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve la entidad de suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo { "id" 12345, "level" "trial", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" } 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 usted solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /self/networks/{name}/subscription/ actualiza la información de suscripción actual asociada con una red especificada un usuario regular solo puede usar esto para habilitar un período de prueba de content cloud (si no se habilitó previamente) token de alcance requerido bsn api self networks update segmento nombre \string \ el nombre de la red cuerpo de la solicitud la entidad de suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en janedoetesting put /2022/06/rest/self/networks/janedoetesting/subscription/ 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 114 este es el cuerpo de solicitud de ejemplo { "id" 0, "level" "trial", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "expiredate" null } respuesta correcta \204\ se actualizó la información de suscripción asociada con la red 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 comerciales \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") \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 get /self/networks/{id}/subscriptions/ devuelve la suscripción actual y todas las suscripciones expiradas anteriormente asociadas con una red especificada token de scope requerido bsn api self networks retrieve segmento id \int \ el identificador de red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 get /2022/06/rest/self/networks/12345/subscriptions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve una matriz de entidades suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo \[ { "id" 12347, "level" "content", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" }, { "id" 12346, "level" "trial", "creationdate" "2020 07 24t23 05 45 517z", "lastmodifieddate" "2020 07 24t23 05 45 517z", "expiredate" "2020 08 17t20 49 45 633z" }, { "id" 12345, "level" "control", "creationdate" "2020 07 09t19 09 05 853z", "lastmodifieddate" "2020 07 09t19 09 05 853z", "expiredate" "2020 07 24t23 05 45 517z" } ] 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ó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /self/networks/{name}/subscriptions/ devuelve la suscripción actual y todas las suscripciones previamente vencidas asociadas con una red especificada token de alcance requerido bsn api self networks retrieve segmento nombre \string \ el nombre de la red ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera nombre se establece en janedoetesting get /2022/06/rest/self/networks/janedoetesting/subscriptions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta exitosa \200\ devuelve un arreglo de entidades de suscripción de red docid 8nz1hmwb4ky emef1odsy ejemplo \[ { "id" 12347, "level" "content", "creationdate" "2020 08 17t20 49 45 633z", "lastmodifieddate" "2020 08 17t20 49 45 633z", "expiredate" "2030 08 16t00 00 00z" }, { "id" 12346, "level" "trial", "creationdate" "2020 07 24t23 05 45 517z", "lastmodifieddate" "2020 07 24t23 05 45 517z", "expiredate" "2020 08 17t20 49 45 633z" }, { "id" 12345, "level" "control", "creationdate" "2020 07 09t19 09 05 853z", "lastmodifieddate" "2020 07 09t19 09 05 853z", "expiredate" "2020 07 24t23 05 45 517z" } ] 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ó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /self/users/ devuelve todas las entidades de usuario con las que el cliente está asociado en todas las redes donde la persona tiene un registro de usuario token de alcance requerido bsn api self users retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera get /2022/06/rest/self/users/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta correcta \200\ devuelve una matriz de entidades de usuario (consulte entidad de usuario docid\ lnibik7fz9mxkikmsure1 ) si el usuario es miembro de varias redes, o una sola entidad de usuario docid\ lnibik7fz9mxkikmsure1 si el usuario es miembro de una sola red, o nada si el usuario no es miembro de ninguna red ejemplo \[ { "id" 12345, "person" { "id" 1234, "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" }, "network" { "id" 1234, "name" "janedoetesting" }, "description" "network administrator", "creationdate" "2020 07 09t19 09 04 98z", "lastmodifieddate" "2020 08 17t20 49 48 377z", "lastlogindate" "2023 12 07t22 11 53 24z", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 54321, "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 de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay varias 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 válido, no proporciona acceso a este método \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 /self/users/{id}/ devuelve información sobre su membresía en una red token de alcance requerido bsn api self users retrieve segmento id \int \ el identificador único de 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/self/users/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} 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 de nivel 200 { "id" 12345, "person" { "id" 1234, "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" }, "network" { "id" 1234, "name" "janedoetesting" }, "description" "network administrator", "creationdate" "2020 07 09t19 09 04 98z", "lastmodifieddate" "2020 08 17t20 49 48 377z", "lastlogindate" "2023 12 07t22 11 53 24z", "islockedout" false, "lastlockoutdate" null, "rolename" "administrators", "permissions" \[ { "entityid" 54321, "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 la hora especificada 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 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 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ó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /self/users/{id}/role/ devuelve información sobre el rol que usted tiene en una red token de scope requerido bsn api self roles retrieve segmento id \int \ el identificador único de un usuario ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 get /2022/06/rest/self/users/12345/role/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ esto devuelve la entidad de usuario docid\ lnibik7fz9mxkikmsure1 ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "iscustom" true, "name" "customrole", "description" "", "creationdate" "2023 07 10t14 16 58 433z", "usercount" 1, "users" null, "permissions" \[ { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "customrole", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 08 17t20 49 45 793z" } ] } respuesta correcta \204\ sin contenido (el usuario no está asignado a un rol) respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está malformada 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 brinda 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 get /self/users/{id}/profile/ devuelve la configuración del perfil del usuario token de alcance requerido bsn api self users profile retrieve segmento id \int \ el identificador único de 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/self/users/12345/profile/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{personaccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ el tipo de retorno es object, donde los nombres de las propiedades son claves de perfil y los valores del perfil son esos valores de propiedad ejemplo { "enablecustomrolesmanagement" "true", "showadvancedsecuritysettings" "false" } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está malformada 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 brinda 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 /self/users/{id}/profile/ crea una nueva propiedad de perfil de usuario (no reemplaza una propiedad de perfil de usuario existente) token de alcance requerido bsn api self users profile update segmento id \int \ el identificador único de un usuario cuerpo de la solicitud par \\<string, string\> \ un par clave valor no debe haber más de 100 propiedades por usuario, y cada valor de propiedad no debe superar los 64kb ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 post /2022/06/rest/self/users/12345/profile/ 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 45 este es el cuerpo de solicitud de ejemplo { 	"key" "new key 1", 	"value" "my value" } cuerpo de la respuesta satisfactoria \201\ devuelve el par clave valor y un enlace al método get para recuperarlo ejemplo { "key" "new key 1", "value" "my value" } 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á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) \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \409\ la propiedad de perfil con la clave especificada ya existe o está reservada \413\ el tamaño del valor de la propiedad de perfil especificada supera el límite de 64kb \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 /self/users/{id}/profile/{key}/ devuelve el valor de una propiedad del perfil de usuario token de scope requerido bsn api self users profile retrieve segmento id \int \ el identificador único de un usuario clave \string \ el nombre de la propiedad del perfil ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 clave se establece en nueva clave 1 get /2022/06/rest/self/users/12345/profile/new%20key%201 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 correcta con cuerpo \200\ devuelve el valor de la clave de perfil de usuario solicitada ejemplo este es un ejemplo de una respuesta con estado 200 "my value" respuesta correcta \304\ el recurso no se modificó desde la hora especificada en el encabezado “if modified since” respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está malformada 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 /self/users/{id}/profile/{key}/ crea o actualiza el valor de una propiedad del perfil de usuario token de scope requerido bsn api self users profile update segmentos id \int \ el identificador único de un usuario clave \string \ el nombre de la propiedad del perfil cuerpo de la solicitud \string \ el valor de la propiedad del perfil que se va a actualizar ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 clave se establece en userstartuppage cadena se establece en "administrador" put /2022/06/rest/self/users/12345/profile/userstartuppage 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 7 este es el cuerpo de solicitud de ejemplo "admin" respuesta correcta \201\ devuelve este código de estado si el valor de la propiedad se define por primera vez \204\ devuelve este código de estado si la propiedad ya existe y ha sido actualizada 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, o la clave especificada de la propiedad del perfil de usuario está reservada o tiene más de 62 caracteres \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 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”) \413\ la longitud de la propiedad especificada del perfil de usuario excede el límite de 64kb \415\ el servidor no puede aceptar la representación de datos que envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /self/users/{id}/profile/{key}/ elimina una propiedad especificada de un perfil de usuario token de scope requerido bsn api self users profile update segmentos id \int \ el identificador único de un usuario clave \string \ el nombre de la propiedad del perfil ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera id se establece en 12345 clave se establece en nueva clave 1 delete /2022/06/rest/self/users/12345/profile/new%20key%201 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 satisfactoria \204\ la propiedad especificada ha sido eliminada del perfil del usuario 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 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 solicitó (según se especifica en el encabezado "accept") \412\ error de condición previa (el recurso cambió desde la fecha especificada en el valor del encabezado “if unmodified since”) \5xx\ cualquier código 500 es un error interno del servidor get /self/users/{id}/permissions/ devuelve los permisos otorgados a un usuario determinado token de scope requerido bsn api self 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/self/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 correcta \200\ devuelve la lista paginada de entidades de permiso docid\ hc70cptqcofqdzw2spaek otorgadas a un usuario específico ejemplo \[ { "entityid" 12345, "operationuid" "67b9b0ab fb5f 36c4 d598 a71aa8998e4e", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 12345 }, "isfixed" true, "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 solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /self/users/{id}/role/permissions/ devuelve los permisos otorgados a un usuario determinado token de scope requerido bsn api self roles 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/self/users/12345/role/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 de éxito \200\ devuelve el array de entidades permiso docid\ hc70cptqcofqdzw2spaek otorgadas a un rol específico ejemplo \[ { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "customrole", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 45 793z" } ] 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 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 get /self/users/{id}/notifications/ devuelve la configuración de notificaciones del usuario token de scope requerido bsn api self users notifications 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/self/users/12345/notifications/ 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 de éxito \200\ devuelve información sobre si cada configuración en entidad de configuración de notificaciones del usuario docid 7msta2keutbl nnormmqa está habilitada o deshabilitada ejemplo { "networksuspendingnotificationenabled" false, "networksuspendingnotificationtemplate" null, "networksuspendednotificationenabled" true, "networksuspendednotificationtemplate" null, "networksubscriptionupgradednotificationenabled" true, "networksubscriptionupgradednotificationtemplate" null, "networktrialperiodstartednotificationenabled" true, "networktrialperiodstartednotificationtemplate" null, "networktrialperiodexpiringnotificationenabled" true, "networktrialperiodexpiringnotificationtemplate" null, "networktrialperiodexpirednotificationenabled" true, "networktrialperiodexpirednotificationtemplate" null, "devicefailurenotificationenabled" false, "devicefailurenotificationtemplate" null, "devicesfailurenotificationenabled" false, "devicesfailurenotificationtemplate" null, "devicedisconnectednotificationenabled" false, "devicedisconnectednotificationtemplate" null, "devicesdisconnectednotificationenabled" false, "devicesdisconnectednotificationtemplate" null, "subscriptioncreatednotificationenabled" false, "subscriptioncreatednotificationtemplate" null, "subscriptionscreatednotificationenabled" false, "subscriptionscreatednotificationtemplate" null, "subscriptionqueuednotificationenabled" false, "subscriptionqueuednotificationtemplate" null, "subscriptionsqueuednotificationenabled" false, "subscriptionsqueuednotificationtemplate" null, "gracesubscriptionexpiringnotificationenabled" false, "gracesubscriptionexpiringnotificationtemplate" null, "gracesubscriptionsexpiringnotificationenabled" false, "gracesubscriptionsexpiringnotificationtemplate" null, "demosubscriptionexpiringnotificationenabled" false, "demosubscriptionexpiringnotificationtemplate" null, "demosubscriptionsexpiringnotificationenabled" false, "demosubscriptionsexpiringnotificationtemplate" null, "subscriptionexpiringnotificationenabled" false, "subscriptionexpiringnotificationtemplate" null, "subscriptionsexpiringnotificationenabled" false, "subscriptionsexpiringnotificationtemplate" null, "subscriptionexpirednotificationenabled" false, "subscriptionexpirednotificationtemplate" null, "subscriptionsexpirednotificationenabled" false, "subscriptionsexpirednotificationtemplate" null, "subscriptionsuspendingnotificationenabled" false, "subscriptionsuspendingnotificationtemplate" null, "subscriptionssuspendingnotificationenabled" false, "subscriptionssuspendingnotificationtemplate" null, "subscriptionsuspendednotificationenabled" true, "subscriptionsuspendednotificationtemplate" null, "subscriptionssuspendednotificationenabled" true, "subscriptionssuspendednotificationtemplate" null } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está malformada 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 /self/users/{id}/notifications/ actualiza la configuración de notificaciones del usuario token de scope requerido bsn api self users notifications update segmento id \int \ un identificador único para un usuario cuerpo de la solicitud la entidad de configuración de notificaciones del usuario docid 7msta2keutbl nnormmqa ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 put /2022/06/rest/self/users/12345/notifications/ 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 2799 este es el cuerpo de la solicitud de ejemplo { "networksuspendingnotificationenabled" false, "networksuspendingnotificationtemplate" null, "networksuspendednotificationenabled" true, "networksuspendednotificationtemplate" null, "networksubscriptionupgradednotificationenabled" true, "networksubscriptionupgradednotificationtemplate" null, "networktrialperiodstartednotificationenabled" true, "networktrialperiodstartednotificationtemplate" null, "networktrialperiodexpiringnotificationenabled" true, "networktrialperiodexpiringnotificationtemplate" null, "networktrialperiodexpirednotificationenabled" true, "networktrialperiodexpirednotificationtemplate" null, "devicefailurenotificationenabled" false, "devicefailurenotificationtemplate" null, "devicesfailurenotificationenabled" false, "devicesfailurenotificationtemplate" null, "devicedisconnectednotificationenabled" false, "devicedisconnectednotificationtemplate" null, "devicesdisconnectednotificationenabled" false, "devicesdisconnectednotificationtemplate" null, "subscriptioncreatednotificationenabled" false, "subscriptioncreatednotificationtemplate" null, "subscriptionscreatednotificationenabled" false, "subscriptionscreatednotificationtemplate" null, "subscriptionqueuednotificationenabled" false, "subscriptionqueuednotificationtemplate" null, "subscriptionsqueuednotificationenabled" false, "subscriptionsqueuednotificationtemplate" null, "gracesubscriptionexpiringnotificationenabled" false, "gracesubscriptionexpiringnotificationtemplate" null, "gracesubscriptionsexpiringnotificationenabled" false, "gracesubscriptionsexpiringnotificationtemplate" null, "demosubscriptionexpiringnotificationenabled" false, "demosubscriptionexpiringnotificationtemplate" null, "demosubscriptionsexpiringnotificationenabled" false, "demosubscriptionsexpiringnotificationtemplate" null, "subscriptionexpiringnotificationenabled" false, "subscriptionexpiringnotificationtemplate" null, "subscriptionsexpiringnotificationenabled" false, "subscriptionsexpiringnotificationtemplate" null, "subscriptionexpirednotificationenabled" false, "subscriptionexpirednotificationtemplate" null, "subscriptionsexpirednotificationenabled" false, "subscriptionsexpirednotificationtemplate" null, "subscriptionsuspendingnotificationenabled" false, "subscriptionsuspendingnotificationtemplate" null, "subscriptionssuspendingnotificationenabled" false, "subscriptionssuspendingnotificationtemplate" null, "subscriptionsuspendednotificationenabled" true, "subscriptionsuspendednotificationtemplate" null, "subscriptionssuspendednotificationenabled" true, "subscriptionssuspendednotificationtemplate" null } respuesta correcta \204\ la configuración de notificaciones del usuario especificado se ha actualizado en la red 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 solicitó (como se especifica en el encabezado "accept") \415\ el servidor no puede aceptar la representación de datos que envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor get /self/applications/ devuelve páginas de aplicaciones registradas por una persona autenticada, según el filtrado especificado, en el orden de la consulta de ordenación especificada token de scope requerido bsn api self applications retrieve parámetros de la cadena de consulta filtro \string\ \opcional \ una expresión docid\ cot2dfqig9wykoya94hex para filtrar resultados de búsqueda el valor predeterminado es null ordenar \string\ \opcional \ una expresión para ordenar los resultados de búsqueda el valor predeterminado es null la expresión de ordenación especifica la entrada utilizada para ordenar y el orden de clasificación ascendente/descendente (asc/desc) (p ej , "\[application] \[name] asc") marcador \string\ \optional \ un valor que especifica qué página recuperar este valor es útil si la entrada istruncated en el cuerpo de respuesta de la llamada get anterior indica que el número de instancias de aplicación excede el pagesize este parámetro solo es necesario si necesita más elementos en la lista paginada que el pagesize (100) pagesize \int\ \optional \ el número máximo de instancias de aplicación que pueden incluirse en el cuerpo de respuesta esto utiliza de forma predeterminada el tamaño máximo de página permitido (100) ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo están configurados de la siguiente manera marcador value is set to the \[pagedlist] \[nextmarker] property value from the previous bsn cloud api response pagesize está configurado en 1 filtro está configurado en \[clientid] es '3fde8d97 2e40 4b0b a76f 445804824799' ordenar está configurado en \[lastmodifieddate] asc get https //api bsn cloud/2022/06/rest/self/applications/?filter=%5bclientid%5d%20is%20%273fde8d97 2e40 4b0b a76f 445804824799%27\&sort=%5blastmodifieddate%5d%20asc\&pagesize=1 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br respuesta correcta con cuerpo \200\ devuelve una lista paginada de entidad de aplicación docid\ halhc tcw1z77irdswtfm ejemplo este es un ejemplo de una respuesta de nivel 200 { "items" \[ { "id" 12345, "owner" { "id" 54321, "login" "janedoe\@brightsign biz" }, "clientid" "3fde8d97 2e40 4b0b a76f 445804824799", "clientsecret" null, "scope" "self info main content upload", "name" "my application", "description" "sample application", "creationdate" "2025 02 10t22 32 59 830z", "lastmodifieddate" "2025 02 10t22 32 59 830z" } ], "totalitemcount" 3, "matchingitemcount" 1, "pagesize" 1, "prevmarker" "mjayns0wmi0xmfqymjozmjo1os44mzbaldm5lhbyzxy=", "nextmarker" "mjayns0wmi0xmfqymjozmjo1os44mzbaldm5lg5lehq=", "istruncated" false, "sortexpression" "\[lastmodifieddate] asc", "filterexpression" "\[clientid] is '3fde8d97 2e40 4b0b a76f 445804824799'" } respuesta de error \300\ la representación solicitada no pudo devolverse 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 válido, no proporciona acceso a este método \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 /self/applications/scopes/ recupera la lista de tokens de alcance disponibles que pueden otorgarse a una aplicación nueva o existente ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo están configurados de la siguiente manera get /2022/06/rest/self/applications/scopes/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br cuerpo de la respuesta exitosa \200\ devuelve la lista de tokens de alcance oauth2 disponibles ejemplo \[ "self applications", "self applications create", "self applications delete", "self applications retrieve", "self applications update", "self info", "self info retrieve", "self info update", "self networks", "self networks create", "self networks retrieve", "self networks update", "self profile", "self profile retrieve", "self profile update", "self roles", "self roles retrieve", "self token", "self token revoke", "self token validate", "self users", "self users notifications retrieve", "self users notifications update", "self users profile retrieve", "self users profile update", "self users retrieve" ] respuesta de error \300\ la representación solicitada no pudo ser devuelta 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 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ó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /self/applications/ registra una nueva aplicación para obtener credenciales de cliente oauth2 token de alcance requerido bsn api self applications create cuerpo de la solicitud la entidad de aplicación docid\ halhc tcw1z77irdswtfm ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo están configurados de la siguiente manera post /2022/06/rest/self/applications/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} content type application/json content length 269 accept application/json, application/problem+json accept encoding gzip,br este es el cuerpo de la solicitud de ejemplo { "id" 0, "name" "my application", "description" "sample application", "owner" null, "scope" "self info main content upload", "clientid" "", "clientsecret" null, "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00" } cuerpo de la respuesta exitosa \201\ devuelve la entidad de aplicación docid\ halhc tcw1z77irdswtfm ejemplo { "id" 12345, "owner" { "id" 54321, "login" "janedoe\@brightsign biz" }, "clientid" "3fde8d97 2e40 4b0b a76f 445804824799", "clientsecret" "echcvgtkzoex3ptkbgxq2upmkmcqvxl7", "scope" "self info main content upload", "name" "my application", "description" "sample application", "creationdate" "2025 02 10t22 32 59 828z", "lastmodifieddate" "2025 02 10t22 32 59 828z" } respuesta de error \300\ la representación solicitada no pudo ser devuelta porque es ambigua (hay múltiples representaciones solicitadas) \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 es invá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 solicitó (según se especifica en el encabezado "accept") \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 /self/applications/ anula el registro de las instancias "application" existentes sin usar que están registradas por una “person” autenticada y cumplen los criterios de filtro especificados, y revoca las credenciales de cliente oauth2 relacionadas token de alcance requerido bsn api self applications delete parámetros de query string filtro \string\ \requerido \ una expresión docid\ cot2dfqig9wykoya94hex para filtrar resultados de búsqueda el valor predeterminado es null ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera filtro se establece en \[creationdate] es anterior a '2025 01 01' delete /2022/06/rest/self/applications/?filter=%5bcreationdate%5d%20is%20before%20%272025 01 01%27 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br cuerpo de la respuesta exitosa \200\ se devuelve el número de entidades eliminadas error \300\ la representación solicitada no se pudo devolver porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, es inválida \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 \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 /self/applications/count/ devuelve el número de instancias de aplicación que están registradas para una persona autenticada y cumplen los criterios de filtro especificados token de alcance requerido bsn api main applications retrieve parámetros de query string filtro \string\ \opcional \ una expresión docid\ cot2dfqig9wykoya94hex para filtrar resultados de búsqueda el valor predeterminado es null ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera filtro se establece en \[creationdate] es anterior a '2025 01 01' get /2022/06/rest/self/applications/count/?filter=%5bcreationdate%5d%20is%20before%20%272025 01 01%27 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br cuerpo de la respuesta exitosa \200\ el recuento de aplicaciones se devuelve como un valor entero respuesta de error \300\ la representación solicitada no pudo devolverse 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 válido, no proporciona acceso a este método \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 get /self/applications/{id}/ devuelve información sobre una “application” registrada por una “person” autenticada y que tiene el “id” especificado token de scope requerido bsn api self applications retrieve segmento id \string \ el identificador único de la aplicación 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/self/applications/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br if modified since thu, 06 jun 2024 17 32 38 gmt respuesta exitosa con cuerpo \200\ devuelve la entidad de aplicación docid\ halhc tcw1z77irdswtfm este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "owner" { "id" 54321, "login" "janedoe\@brightsign biz" }, "clientid" "3fde8d97 2e40 4b0b a76f 445804824799", "clientsecret" null, "scope" "self info main content upload", "name" "my application", "description" "sample application", "creationdate" "2025 02 10t22 32 59 828z", "lastmodifieddate" "2025 02 10t22 32 59 828z" } \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 está mal formada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se ha especificado \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ó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /self/applications/{id}/ edita la información sobre una aplicación que tiene un id especificado token de alcance requerido bsn api main applications update segmento id \int \ un identificador único para una aplicación cuerpo de la solicitud la entidad de aplicación docid\ halhc tcw1z77irdswtfm ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id es 12345 put /2022/06/rest/self/applications/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} content type application/json content length 269 accept application/json, application/problem+json accept encoding gzip,br if unmodified since thu, 06 jun 2024 17 32 38 gmt este es el cuerpo de la solicitud de ejemplo { "id" 0, "name" "my application", "description" "sample application", "owner" null, "scope" "self info main content upload", "clientid" "", "clientsecret" null, "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00" } respuesta exitosa \204\ la aplicación especificada ha sido actualizada en la red 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á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 ha especificado \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 \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \412\ error de condición previa (el recurso/aplicación 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 envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /self/applications/{id}/ cancela el registro de la instancia existente de “application” sin usar registrada por una “person” autenticada y que tiene el “id” especificado, y revoca las credenciales de cliente oauth2 relacionadas token de alcance requerido bsn api self applications delete segmento id \string \ el identificador único de la aplicación 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/self/applications/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br if unmodified since thu, 06 jun 2024 17 32 38 gmt respuesta correcta \204\ la aplicación especificada ha sido eliminada respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida, o se rechaza de acuerdo con las reglas de negocio por ejemplo, pueden existir usuarios del servicio de la aplicación para esta aplicación y deben eliminarse antes de que pueda eliminarse \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 la hora especificada en el valor del encabezado “if unmodified since”) \5xx\ cualquier código 500 es un error interno del servidor post /self/applications/{id}/secret/ rota el secreto de cliente oauth2 de una instancia existente de “application” registrada por una “person” autenticada y que tiene el “id” especificado consulte esta página https //stackoverflow\ com/questions/75571740/how to create keyclock clientsecret via api token de alcance requerido bsn api self applications update ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 post /2022/06/rest/self/applications/12345/secret/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/problem+json accept encoding gzip,br if unmodified since thu, 06 jun 2024 17 32 38 gmt cuerpo de la respuesta correcta \200\ invalida el secreto del cliente oauth2 actual y emite uno nuevo para una aplicación determinada ejemplo "jqvhz360hrnymsu45yx25n8tvngwxzcb" 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án mal formados y, por lo tanto, son invá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\ no se puede encontrar la aplicación referenciada \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \412\ falló la condición previa (el recurso/grupo cambió desde el momento especificado en el valor del encabezado “if unmodified since”) \5xx\ cualquier código 500 es un error interno del servidor