convert_file
Para convertir archivos XLSX y CSV a JSON, use el método exchange/convert_file:
svc=exchange/convert_file¶ms={"format":"csv", "separator":","}
El tamaño máximo del archivo es de 64 MB.
Parámetros
Los parámetros obligatorios están marcados con un asterisco (*).
| Parámetro | Descripción |
|---|---|
| format* | Formato del archivo. Los formatos compatibles son XLSX y CSV. |
| separator* | Separador. Solo para archivos CSV. |
| eventHash | Nombre del evento que se genera después de leer los datos. |
Para convertir un archivo, use una solicitud POST con contenido múltiple (multipart/form-data). En form-data, cree un parámetro independiente del tipo file e indique el nombre del archivo. En Postman, por ejemplo, puede hacerlo en query params.
Ejemplo de solicitud:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/convert_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"
jUploadForm1372772377019
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="import_file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Respuesta
Si el archivo se convierte correctamente, se devuelve un texto en formato JSON. Si la solicitud no contiene el parámetro eventHash, la respuesta se devuelve inmediatamente. Si lo contiene, ejecute el método avl_evts para ver el resultado.
Ejemplo de respuesta:
{
"filename": "test.xlsx",
"sheets": [
{
"rows": [
[
"№",
"Time",
"User",
"Object type",
"Action",
"Host",
"Notes"
],
[
"1",
"2023-09-13 10:45:15",
"maqsat",
"Resource",
"Resource 'Radares Maqsat' created.",
"167.61.60.214",
" "
],
[
"2",
"2023-09-13 10:45:16",
"maqsat",
"Resource",
"Account 'Radares Maqsat' created.",
"167.61.60.214",
" "
]
]
}
]
}
Si no se pudo convertir el archivo, se devuelve un código de error.
Códigos de error
| Código | Descripción |
|---|---|
| 4 | Tamaño de archivo excesivo, parámetros de entrada no válidos o formato de archivo desconocido. |
| 5 | No se pudo abrir o convertir el archivo. |
| 6 | Error desconocido. |
| 7 | Sin acceso. |