upload_file
Para cargar archivos y obtener su contenido en un evento de la sesión, utilice el método unit/upload_file. El método no guarda los archivos en una unidad ni en ninguna otra parte del servidor:
svc=unit/upload_file¶ms={
"eventHash": <text>,
"toHex": <uint>
}
Parámetros
Todos los parámetros son opcionales. El archivo en sí es obligatorio: si la solicitud no contiene ningún archivo, se devuelve el código de error 4.
| Parámetro | Descripción |
|---|---|
| toHex | Convertir los datos binarios en una cadena de texto: 0 (no), 1 (sí). |
| eventHash | Nombre del evento que se genera en la sesión después de cargar los archivos. El evento contiene este nombre y el contenido de cada archivo cargado (en formato hexadecimal si toHex es 1). Si el parámetro no se especifica, no se genera ningún evento. |
Carga del archivo
Para cargar un archivo, utilice una solicitud POST con contenido compuesto (multipart/form-data), en la que una parte contiene los parámetros y la otra, el archivo. Por ejemplo:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=unit/upload_file&sid=SESSION_IDENTIFIER
Request Method: POST
Connection: keep-alive
Content-Length: 1901
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryhAXcAjtvh1D61XpC
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
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="params"
{"eventHash":"jUploadForm1372772377019","toHex":1}
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Respuesta
Si la solicitud se ejecuta correctamente, se devuelve un objeto vacío:
{}
Para comprobar que el archivo se ha cargado, utilice el método requests/avl_evts.
Si la solicitud falla, se devuelve el código de error 4, que indica que la solicitud no contiene ningún archivo.