import_json
To read data from a WLP file, use the exchange/import_json method.
Endpoint
svc=exchange/import_json¶ms={
"eventHash": <text>
}
The method is a resource-intensive request, so the limit on simultaneous resource-intensive requests during one session applies to it. If the limit is reached, the error 1003 with the
LIMIT api_concurrentreason is returned. For the list of resource-intensive requests, see Limitations.
Parameters
You can include the optional parameter eventHash in the request. It allows specifying the event name which is generated after reading the data.
Loading a file
To load a WLP file, use a POST request with multiple contents (multipart/form-data). For example:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_json&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"}
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="eventHash"
jUploadForm1372772377019
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="import_file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Response
If the request is completed successfully, an empty response is returned.
{ }
To make sure that the data has been read, you can execute the avl_evts method:
{
"tm": <uint>, /* current server time (UTC) */
"events": [
{
"i": -1,
"d": { /* data */
"hash": <text>, /* upload complete */
"files": { /* files uploaded */
<text>: <Object>, /* file name: file data */
...
}
}
}
]
}
If the request fails, an error code is returned.
Error codes
| Error code | Description |
|---|---|
| 1 | Invalid or obsolete request SID. |
| 4 | No files attached. |
| 7 | Failed to obtain the current user. |