upload_image
Para cargar una imagen para una unidad, utilice el método unit/upload_image.
svc=unit/upload_image¶ms={
"itemId": <long>,
"eventHash": <text>
}
Parámetros
La solicitud puede contener los siguientes parámetros. Los obligatorios están marcados con un asterisco (*).
| Parámetro | Descripción |
|---|---|
itemId* |
ID de la unidad. |
eventHash |
Nombre del evento que se genera después de cargar la imagen. |
Carga de la imagen
Para cargar una imagen, utilice una solicitud POST con contenido múltiple (multipart/form-data), en la que una parte contiene los parámetros y la otra, la imagen. Por ejemplo:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=unit/upload_image&sid=SESSION_IDENTIFIER
Request Method: POST
Host: hst-api.wialon.com
Connection: keep-alive
Content-Length: 31720
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryECovXn5tfw5muHk8
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
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="params"
{"itemId":911903,"eventHash":"jUploadForm1372769354768"}
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="eventHash"
jUploadForm1372769354768
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="icon_file"; filename="image.jpg"
Content-Type: image/jpeg
------WebKitFormBoundaryECovXn5tfw5muHk8--
Respuesta
Si la solicitud se completa con éxito, se devuelve un objeto vacío:
{}
Para comprobar que la imagen se ha cargado, utilice el método requests/avl_evts.
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. |
| 6 | No se pudo guardar la imagen. |
| 7 | La unidad no existe o el usuario no tiene el derecho de acceso Cambiar icono a ella. |