Puntos de conexión de almacenamiento de rDWS

10 min

url base para estos endpoints https //ws bsn cloud/rest/v1/ get /files/{\ path}/ enumera los directorios y/o archivos en una ruta segmento ruta \string\ la ruta a los directorios o archivos parámetro de query string crudo \optional\ devuelve el contenido sin procesar de un directorio contenido \optional\ si se especifica un archivo, esto devolverá el contenido de ese archivo ejemplo de solicitud get /rest/v1/files/sd/autorun brs/?destinationtype=player\&destinationname={{deviceserial}} http/1 1 host ws bsn cloud authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json cuerpo de la respuesta tipo \string\ ya sea un directorio o un archivo ruta \string\ la ruta; por ejemplo, "sd" stat \object\ estadísticas del directorio del módulo "fs" archivos \object\[ ]\ nombre \string\ nombre del archivo o directorio tipo \string\ ya sea "file" o "dir" ruta \string\ la ruta relativa del archivo o directorio stat \object\ estadísticas del archivo del módulo “fs” mimo \string\ tipo mime (disponible solo para el tipo "file") storageinfo \object\ si la ruta en la url es un dispositivo de almacenamiento, esto devuelve información sobre el dispositivo de almacenamiento para obtener más información, consulte storageinfo docid\ qwqyzz0go5g99z3dfzqdp tipodesistemadearchivos \string\ el tipo de sistema de archivos (por ejemplo, "fat32") estadísticas \object\ blocksize \int\ el tamaño de un bloque nativo bytesfree \int\ la cantidad de espacio libre filesfree \int\ el número de inodos usados filesused \int\ el número de inodos libres isreadonly \bool\ una marca que indica si el sistema de archivos es de solo lectura sizebytes \int\ la cantidad de espacio total montado en \string\ la ubicación donde está montado el sistema de archivos (por ejemplo, "/storage/sd") contenido \object\[ ]\ nombre \string\ el nombre del archivo o directorio tipo \string\ ya sea "file" o "dir" ruta \string\ la ruta absoluta del archivo o directorio stat \object\ las estadísticas del módulo "fs" mimo \string\ tipo mime (disponible solo para el tipo "file") niños \object\[ ]\ esto está disponible solo para tipos de directorio y tendrá el mismo formato que "contents cuerpo de respuesta al devolver contenidos nombre \string\ el nombre del archivo mimetype \string\ tipo mime del archivo contenido \string\ el contenido del archivo ejemplos de respuesta { "route" "/v1/files/sd/autorun brs", "method" "get", "data" { "result" { "name" "sd/autorun brs", "type" "file", "path" "sd/autorun brs", "mime" "application/octet stream", "stat" { "dev" 45921, "mode" 33277, "nlink" 1, "uid" 0, "gid" 1003, "rdev" 0, "blksize" 32768, "ino" 40, "size" 1144340, "blocks" 2240, "atimems" 1699401600000, "mtimems" 1699423824000, "ctimems" 1699423824440, "birthtimems" 0, "atime" "2023 11 08t00 00 00 000z", "mtime" "2023 11 08t06 10 24 000z", "ctime" "2023 11 08t06 10 24 440z", "birthtime" "1970 01 01t00 00 00 000z" }, "filesize" 1144340, "streamable" true } } } si pasó un parámetro de consulta contenido en su solicitud, debería esperar una respuesta como la siguiente tenga en cuenta que una vez que tenga la cadena de datos, tendrá que decodificarla (por ejemplo, con el método atob en javascript) { "route" "/v1/files/sd/autorun brs", "method" "get", "data" { "result" { "mimetype" null, "name" "autorun brs", "contents" "tglicmfyesaiyxv0b3b \<very large data string> " } } } put /files/{\ path} carga un nuevo archivo o carpeta en el almacenamiento del reproductor si está cargando archivos zip y multimedia, debe usar bos versión 8 5 44 o 9 0 101 o posterior segmento ruta \string\ la ruta es la carpeta en la que desea cargar el archivo (por ejemplo "/sd" ) cuerpo de la solicitud archivos \object\[]\ filename \string\ el nombre del archivo contenidodelarchivo \string\ el contenido del archivo puede proporcionarse como texto sin formato o como data url tipo de archivo \string\ tipo mime ejemplo de solicitud (archivo) el siguiente ejemplo de solicitud se usaría con uno de los dos ejemplos de cuerpo de solicitud (texto sin formato o data url) a continuación put /rest/v1/files/sd/?destinationtype=player\&destinationname={{deviceserial}} http/1 1 host ws bsn cloud authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json content type application/json content length 196 en los ejemplos de cuerpo de solicitud a continuación, use el método filereader's readastext() https //developer mozilla org/en us/docs/web/api/filereader/readastext o readasdataurl() https //developer mozilla org/en us/docs/web/api/filereader/readasdataurl para derivar el valor de contenidodelarchivo cuerpo de solicitud de texto sin formato cualquier archivo con tipo mime "text/ ", o cualquier extensión “brs”, “json”, “js”, “xml”, “rtf”, puede enviarse como texto sin formato usando el método filereader's readastext() https //developer mozilla org/en us/docs/web/api/filereader/readastext { "data" { "fileuploadpath" "/sd", "files" \[ { "filename" "test txt", "filecontents" "lorem ipsum", "filetype" "text/plain" } ] } } cuerpo de solicitud data url para todos los demás tipos de archivo, incluidos archivos zip y multimedia, use el formato data url usando el método filereader's readasdataurl() https //developer mozilla org/en us/docs/web/api/filereader/readasdataurl { "data" { "fileuploadpath" "/sd", "files" \[ { "filename" "image png", "filecontents" "data\ image/png;base64,dqpjbnrlcmzh ", "filetype" "image/png" } ] } } cuerpo de la respuesta éxito \bool\ un indicador que señala si la operación se realizó correctamente o no resultados \string\[]\ los nombres de los archivos que se crearon correctamente ejemplo de respuesta (archivo de texto sin formato) { "data" { "result" { "success" true, "results" \[ "test txt" ] } }, "route" "/v1/files/sd", "method" "put" } ejemplo de solicitud (carpeta) put /rest/v1/files/sd/testfolder/?destinationtype=player\&destinationname={{deviceserial}} host ws bsn cloud authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json ejemplo de respuesta (carpeta) { "route" "/v1/files/sd/testfolder/", "method" "put", "data" { "result" { "success" true } } } post /files/{\ path}/ cambia el nombre de un archivo en la ruta (que debe incluir el nombre del archivo) segmento ruta \string\ la ruta al archivo (por ejemplo, /sd ) ejemplo de solicitud post /rest/v1/files/sd/test txt/?destinationtype=player\&destinationname={{deviceserial} http/1 1 host ws bsn cloud authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json content type application/json content length 57 este es el cuerpo de la solicitud de ejemplo { "data" { "name" "newname txt" } } cuerpo de la respuesta el reproductor devolverá un mensaje de éxito o error delete /files/{\ path}/ elimina un archivo del almacenamiento del reproductor segmento ruta \string\ la ruta al archivo (por ejemplo, /sd ) ejemplo de solicitud delete /rest/v1/files/sd/test txt/?destinationtype=player\&destinationname={{deviceserial}} http/1 1 host ws bsn cloud authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json cuerpo de la respuesta el reproductor devolverá un mensaje de éxito o error