Endpoints de la API de carga (2019/03)

18 min

los endpoints de upload permiten a los usuarios enviar archivos al servidor bsn cloud url base para este endpoint https //api bsn cloud/upload/2019/03/rest eliminar /sessions/{sessiontoken}/ cancela la sesión de carga de contenido especificada segmento tokendesesión \string\ el token de la sesión content upload generado por el servidor ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en wixmjm0nty3odkwiiwibmf delete /upload/2019/03/rest/sessions/wixmjm0nty3odkwiiwibmf/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2024 21 32 34 gmt accept application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa \204\ la sesión content upload especificada se canceló correctamente respuesta de error \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\ no se encontró la sesión content upload con el token de sesión especificado \412\ el estado actual de la sesión content upload tiene una marca de tiempo diferente a la especificada en la solicitud \5xx\ cualquier código 500 es un error interno del servidor publicar /sessions/{sessiontoken}/uploads/ crea una nueva content upload ya sea dentro del alcance de la sesión content upload especificada o de forma independiente segmento tokendesesión \string\ el token de la sesión content upload generado por el servidor o ninguno si la nueva content upload es independiente cuerpo de la solicitud el argumentosdecargadecontenido (2019/03) docid\ v5svfabct6ztxkkli3nia ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en wixmjm0nty3odkwiiwibmf ejemplo de content upload post /upload/2019/03/rest/sessions/wixmjm0nty3odkwiiwibmf/uploads/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/vnd bsn content upload status 201903+json, application/vnd bsn content upload negotiation status 201903+json, application/vnd bsn error+json accept encoding gzip,deflate esta solicitud admite múltiples representaciones de payload para los diferentes casos de uso la representación application/vnd bsn start content upload arguments 201903+json se utiliza para iniciar la nueva carga de entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf como se muestra en el siguiente ejemplo application/vnd bsn start content upload arguments 201903+json content type application/vnd bsn start content upload arguments 201903+json content length 277 { "sessiontoken" null, "uploadtoken" null, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } la representación application/vnd bsn start content update arguments 201903+json se utiliza para modificar la entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf cargada previamente, como se muestra en el siguiente ejemplo application/vnd bsn start content update arguments 201903+json content type application/vnd bsn start content update arguments 201903+json content length 300 { "sessiontoken" null, "uploadtoken" null, "contentid" 12345, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } la representación application/vnd bsn start webpage asset upload arguments 201903+json se utiliza para modificar el entidad de activos de página web (2022/06) docid\ hgr428lxflth91lm4jvqn cargado previamente, como se muestra en el siguiente ejemplo application/vnd bsn start webpage asset upload arguments 201903+json content type application/vnd bsn start webpage asset upload arguments 201903+json content length 371 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" null, "webpageassetid" 0, "relativepath" "/assets/text/", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } cuerpo de la respuesta correcta \201\ devuelve el uri y la marca de tiempo de la entidad estado de carga de contenido (2019/03) docid 1g9f bcv4n9jgcmbupxmc ejemplos esta respuesta admite múltiples representaciones de payload para los diferentes casos de uso la representación application/vnd bsn content upload status 201903+json de estado de carga de contenido (2019/03) docid 1g9f bcv4n9jgcmbupxmc que se utiliza para cargas de contenido que no tienen equivalentes en la carpeta de destino application/vnd bsn content upload status 201903+json { "sessiontoken" "", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 0, "filename" "hello world txt", "filesize" 12, "sha1hash" "", "state" "started", "starttime" "2025 08 26t23 47 37 937z", "endtime" null, "lastactivitytime" "2025 08 26t23 47 37 937z", "chunks" \[ { "count" 0, "length" 12, "state" "uploading" } ] } la representación application/vnd bsn content upload negotiation status 201903+json de estado de negociación de contenido (2019/03) docid\ ctmmzxlqd b6khhkoxhvo que se utiliza para indicar que hay contenido equivalente en la carpeta de destino y proporcionar detalles al respecto application/vnd bsn content upload negotiation status 201903+json { "sessiontoken" "", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 0, "filename" "hello world txt", "filesize" 12, "sha1hash" "", "state" "started", "starttime" "2025 08 26t23 47 37 937z", "endtime" null, "lastactivitytime" "2025 08 26t23 47 37 937z", "chunks" null, "matchingfiles" \[ { "id" 12345, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "text", "filesize" 12, "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "uploaddate" "2025 08 05t16 30 15 003z" } ] } respuesta de error \300\ no se especifican las representaciones aceptables de content upload \400\ los content upload arguments especificados están incompletos o no son aceptables \401\ el token de acceso es inválido o no se especificó \404\ no se encontró la sesión de carga de contenido con el token de sesión especificado \406\ la representación especificada de la entidad content upload no es aceptable \415\ la representación especificada de los argumentos de content upload es inválida o no es compatible \5xx\ cualquier código 500 es un error interno del servidor get /sessions/{sessiontoken}/uploads/{uploadtoken}/ recupera el estado de la content upload especificada segmento tokendesesión \string\ el content upload session token generado por el servidor o ninguno si la nueva content upload es independiente token de carga \string\ el upload token generado por el servidor ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en ninguno token de carga se establece en 321e6fc1 553f 4bb0 8c7a d5bf859be6b2 get /upload/2019/03/rest/sessions/none/uploads/321e6fc1 553f 4bb0 8c7a d5bf859be6b2/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since wed, 20 dec 2024 21 32 34 gmt accept application/vnd bsn content upload status 201903+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ se recuperó correctamente estado de carga de contenido (2019/03) docid 1g9f bcv4n9jgcmbupxmc ejemplo application/vnd bsn content upload status 201903+json { "sessiontoken" "", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 0, "filename" "hello world txt", "filesize" 12, "sha1hash" "", "state" "started", "starttime" "2025 08 26t23 47 37 937z", "endtime" null, "lastactivitytime" "2025 08 26t23 47 37 937z", "chunks" \[ { "count" 0, "length" 12, "state" "uploading" } ] } respuesta exitosa \304\ la marca de tiempo especificada en la solicitud es igual o más reciente que la marca de tiempo en el estado actual de content upload respuesta de error \300\ no se especifican representaciones aceptables de content upload session \401\ el token de acceso es inválido o no se especificó \404\ no se encontró una sesión de content upload con el token de sesión especificado o no se encontró la content upload con el token de carga especificado \406\ la representación especificada de la entidad content upload session no es aceptable \5xx\ cualquier código 500 es un error interno del servidor put /sessions/{sessiontoken}/uploads/{uploadtoken}/ actualiza el estado de la content upload especificada segmento sessiontoken \string\ el content upload session token generado por el servidor o ninguno si la nueva carga de contenido es independiente token de carga \string\ el content upload token generado por el servidor cuerpo de la solicitud los argumentosdecargadecontenido (2019/03) docid\ v5svfabct6ztxkkli3nia para una nueva carga de contenido, o argumentosdeactualizacióndecontenido (2019/03) docid\ hk2tr n4tn59kyqdnjixd para editar el contenido existente (cargado previamente), o \ \ para una nueva carga de recursos de página web ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en ninguno token de carga se establece en 321e6fc1 553f 4bb0 8c7a d5bf859be6b2 ejemplo de carga, inicio y finalización de contenido put /upload/2019/03/rest/sessions/none/uploads/321e6fc1 553f 4bb0 8c7a d5bf859be6b2/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2024 21 32 34 gmt accept application/vnd bsn content upload status 201903+json, application/vnd bsn content upload negotiation status 201903+json, application/vnd bsn error+json accept encoding gzip,deflate esta solicitud admite múltiples representaciones de payload para los diferentes casos de uso la representación application/vnd bsn start content upload arguments 201903+json se utiliza para iniciar una carga de entidad @content dentro de una sesión en curso como se muestra en el siguiente ejemplo application/vnd bsn start content upload arguments 201903+json content type application/vnd bsn start content upload arguments 201903+json content length 345 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } la representación application/vnd bsn content upload arguments 201903+json se utiliza para aclarar una carga de entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf en curso como se muestra en el siguiente ejemplo application/vnd bsn content upload arguments 201903+json content type application/vnd bsn content upload arguments 201903+json content length 351 { "sessiontoken" null, "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } la representación application/vnd bsn complete content upload arguments 201903+json se utiliza para completar cargas de entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf iniciadas previamente como se muestra en el siguiente ejemplo application/vnd bsn complete content upload arguments 201903+json content type application/vnd bsn complete content upload arguments 201903+json content length 351 { "sessiontoken" null, "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } la representación application/vnd bsn start content update arguments 201903+json se utiliza para iniciar una nueva carga que modifica el entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf cargado previamente, como se muestra en el siguiente ejemplo application/vnd bsn start content update arguments 201903+json content type application/vnd bsn content update arguments 201903+json content length 368 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 12345, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } la representación application/vnd bsn content update arguments 201903+json se utiliza para aclarar una carga en curso que modifica un entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf cargado previamente, como se muestra en el siguiente ejemplo application/vnd bsn content update arguments 201903+json content type application/vnd bsn start content update arguments 201903+json content length 374 { "sessiontoken" null, "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 12345, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } la representación application/vnd bsn complete content upload arguments 201903+json se utiliza para finalizar una carga que modifica el entidad de contenido (2022/06) docid\ ygeyaznljl tsh1ojbbuf cargado previamente, como se muestra en el siguiente ejemplo application/vnd bsn complete content upload arguments 201903+json content type application/vnd bsn complete content upload arguments 201903+json content length 374 { "sessiontoken" null, "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 12345, "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } la representación application/vnd bsn start webpage asset upload arguments 201903+json se utiliza para mostrar el estado de una nueva carga de entidad de activos de página web (2022/06) docid\ hgr428lxflth91lm4jvqn como se muestra en el siguiente ejemplo application/vnd bsn start webpage asset upload arguments 201903+json content type application/vnd bsn start webpage asset upload arguments 201903+json content length 371 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "webpageassetid" 0, "relativepath" "/assets/text/", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "", "filethumb" null, "tags" {} } la representación application/vnd bsn webpage asset upload arguments 201903+json se utiliza para aclarar una carga en curso de entidad de activos de página web (2022/06) docid\ hgr428lxflth91lm4jvqn como se muestra en el siguiente ejemplo application/vnd bsn webpage asset upload arguments 201903+json content type application/vnd bsn webpage asset upload arguments 201903+json content length 445 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "webpageassetid" 0, "relativepath" "/assets/text/", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } la representación application/vnd bsn complete webpage asset upload arguments 201903+json se utiliza para completar cargas de entidad de activos de página web (2022/06) docid\ hgr428lxflth91lm4jvqn iniciadas previamente, como se muestra en el siguiente ejemplo application/vnd bsn complete webpage asset upload arguments 201903+json content type application/vnd bsn complete webpage asset upload arguments 201903+json content length 445 { "sessiontoken" "271e6422 704f 4c6f b6dc 60c17a00f0fc", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "webpageassetid" 0, "relativepath" "/assets/text/", "filename" "hello world txt", "virtualpath" "\\\shared\\\unsorted\\\\", "mediatype" "auto", "filesize" 12, "filelastmodifieddate" "0001 01 01t00 00 00", "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "filethumb" null, "tags" {} } cuerpo de la respuesta exitosa \200\ devuelve el estado de carga de contenido (2019/03) docid 1g9f bcv4n9jgcmbupxmc ejemplo application/vnd bsn content upload status 201903+json { "sessiontoken" "", "uploadtoken" "321e6fc1 553f 4bb0 8c7a d5bf859be6b2", "contentid" 0, "filename" "hello world txt", "filesize" 12, "sha1hash" "2ef7bde608ce5404e97d5f042f95f89f1c232871", "state" "started", "starttime" "2025 08 26t23 47 37 937z", "endtime" null, "lastactivitytime" "2025 08 26t23 47 37 937z", "chunks" \[ { "count" 0, "length" 12, "state" "uploading" } ] } respuesta de error \300\ no se especifican las representaciones aceptables de la sesión de carga de contenido \400\ los argumentos de la sesión de carga de contenido especificados están incompletos o no son aceptables \401\ el token de acceso no es válido o no fue especificado \404\ no se encontró la sesión de carga de contenido con el token de sesión especificado o no se encontró la carga de contenido con el token de carga especificado \406\ la representación especificada de la entidad de sesión de carga de contenido no es aceptable \412\ el estado actual de la sesión de carga de contenido tiene una marca de tiempo diferente a la especificada en la solicitud \415\ la representación especificada de los argumentos de la sesión de carga de contenido no es válida o no es compatible \5xx\ cualquier código 500 es un error interno del servidor eliminar /sessions/{sessiontoken}/uploads/{uploadtoken}/ cancela la carga de contenido especificada segmento tokendesesión \string\ el token de sesión de carga de contenido generado por el servidor o ninguno si la nueva carga de contenido es independiente token de carga \string\ el token de carga de contenido generado por el servidor ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en ninguno token de carga se establece en 321e6fc1 553f 4bb0 8c7a d5bf859be6b2 delete /upload/2019/03/rest/sessions/none/uploads/321e6fc1 553f 4bb0 8c7a d5bf859be6b2/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2024 21 32 34 gmt accept application/vnd bsn error+json accept encoding gzip,deflate respuesta exitosa \204\ la carga de contenido especificada fue cancelada correctamente respuesta de error \401\ el token de acceso no es válido o no fue especificado \404\ no se encontró la sesión de carga de contenido con el token de sesión especificado o no se encontró la carga de contenido con el token de carga especificado \412\ el estado actual de la carga de contenido tiene una marca de tiempo diferente a la especificada en la solicitud \5xx\ cualquier código 500 es un error interno del servidor get /sessions/{sessiontoken}/uploads/{uploadtoken}/chunks/ recupera el estado de los content chunks en la content upload activa especificada segmento tokendesesión \string\ el content upload session token generado por el servidor o ninguno si la nueva content upload es independiente token de carga \string\ el content upload token generado por el servidor ejemplos de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera tokendesesión se establece en ninguno token de carga se establece en 321e6fc1 553f 4bb0 8c7a d5bf859be6b2 get /upload/2019/03/rest/sessions/none/uploads/321e6fc1 553f 4bb0 8c7a d5bf859be6b2/chunks/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/vnd bsn upload content chunk status list 201903+json accept encoding gzip,deflate cuerpo de la respuesta satisfactoria \200\ se recuperó correctamente una matriz de entidades contentchunkstatus (2019/03) docid\ sleotb0pkhkuxdm7ujsfe ejemplo application/vnd bsn upload content chunk status list 201903+json \[ { "count" 0, "length" 12, "state" "uploading" } ] respuesta de error \300\ las representaciones aceptables de content upload session no están especificadas \401\ el token de acceso no es válido o no está especificado \404\ no se encontró una content upload session con el token de sesión especificado o no se encontró la content upload con el token de carga especificado \406\ la representación especificada de la entidad content chunk no es aceptable \5xx\ cualquier código 500 es un error interno del servidor post /sessions/{sessiontoken}/uploads/{uploadtoken}/chunks/ carga un nuevo content chunk dentro del alcance del contentchunkstatus (2019/03) docid\ sleotb0pkhkuxdm7ujsfe parámetros de query string desplazamiento \string \ \required\ posición inicial de la parte del archivo actual segmento tokendesesión \string\ el content upload session token generado por el servidor o ninguno si la nueva content upload es independiente token de carga \string\ el token de carga de contenido generado por el servidor cuerpo de la solicitud el contentchunkstatus (2019/03) docid\ sleotb0pkhkuxdm7ujsfe ejemplos de solicitud los parámetros y encabezados de solicitud de ejemplo se configuran de la siguiente manera desplazamiento se establece en 0 tokendesesión se establece en ninguno token de carga se establece en 321e6fc1 553f 4bb0 8c7a d5bf859be6b2 post /upload/2019/03/rest/sessions/none/uploads/321e6fc1 553f 4bb0 8c7a d5bf859be6b2/chunks/?offset=0 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/vnd bsn error+json accept encoding gzip,deflate content type application/octet stream content length 12 este es el cuerpo de solicitud de ejemplo application/octet stream hello world! respuesta exitosa \202\ el content chunk especificado se ha agregado correctamente a la cola respuesta de error \4\ \00\ los datos del content chunk especificado están incompletos o no son aceptables \401\ el token de acceso no es válido o no se ha especificado \404\ no se encontró una sesión de carga de contenido con el token de sesión especificado o no se encontró la carga de contenido con el token de carga especificado \415\ el formato del content chunk especificado no es válido o no es compatible \5xx\ cualquier código 500 es un error interno del servidor