put
Para cargar archivos en el almacenamiento de archivos, utilice el método file/put.
svc=file/put¶ms={
"itemId": <long>,
"storageType": <uint>,
"path": <text>,
"writeType": <uint>,
"eventHash": <text>
}&sid=<text>
Parámetros
| Parámetro | Descripción |
|---|---|
| itemId | ID del elemento. |
| storageType | Tipo de almacenamiento: 1 — público (todos los usuarios pueden ver y descargar los archivos), 2 — protegido (solo los usuarios con derechos de acceso pueden ver y descargar los archivos). |
| path | Ruta relativa desde la carpeta raíz hasta el archivo. |
| writeType | Tipo de escritura: 0 — sobrescribir el archivo, 1 — añadir al contenido del archivo, 2 — no sobrescribir si el archivo ya existe. |
| eventHash | Nombre del evento que se generará después de procesar los datos. |
Un archivo no puede tener el mismo nombre que una carpeta.
Para cargar varios archivos, envíelos mediante una solicitud POST con parámetros (multipart/form-data). Por ejemplo:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=file/put
Request Method: POST
Connection: keep-alive
Content-Length:333998
Cache-Control:max-age=0
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryMpLUirMexsfCGaJP
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Charset: windows-1251,utf-8;q=0.7,*;q=0.3
Accept-Encoding: gzip,deflate,sdch
Accept-Language: ru,en-US;q=0.8,en;q=0.6
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="params"
{"itemId":439,"storageType":"1","path":"1","writeType":0,"eventHash":"jUploadForm1414572405484"}
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="eventHash"
jUploadForm1414572405484
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="f"; filename="one-file"
Content-Type: application/octet-stream
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC--
Respuesta
Si la solicitud se completa con éxito, se devuelve la siguiente respuesta:
{
"error":0
}
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código | Descripción |
|---|---|
| 1 | Usuario no autorizado. |
| 4 | Parámetros de entrada incorrectos. |
| 7 | No se encontró el elemento indicado en el parámetro itemId, el valor de storageType no es válido o usted no tiene los derechos de acceso Ver y descargar archivos y Cargar y eliminar archivos al elemento. |