export_messages

Para exportar mensajes (cargados en una capa o directamente) a un archivo, use el método exchange/export_messages.

svc=exchange/export_messages&params={
  "layerName": <text>,
  "format": <text>,
  "itemId": <long>,
  "timeFrom": <uint>,
  "timeTo": <uint>,
  "compress": <bool>
}

El método es una solicitud que consume muchos recursos, por lo que se le aplica la restricción de solicitudes simultáneas de este tipo durante una sesión. Si se alcanza la restricción, se devuelve el error 1003 con la causa LIMIT api_concurrent. Para ver la lista de solicitudes que consumen muchos recursos, consulte Restricciones.

Los parámetros obligatorios están marcados con un asterisco (*).

Se devuelve un archivo del formato especificado.

Si en la solicitud se especifican los campos itemId, timeFrom, timeTo, format y compress a la vez, la unidad se obtiene según el valor de itemId y, a continuación, se obtienen los mensajes de la unidad desde timeFrom hasta timeTo y se devuelven en la respuesta. En este caso, el campo layerName se ignora, aunque se haya especificado en la solicitud. De lo contrario, si falta al menos uno de los campos itemId, timeFrom, timeTo, format y compress en la solicitud, la capa se obtiene según el valor de layerName y, después, la unidad se obtiene de la capa y se devuelven todos sus mensajes. En este caso, los campos timeFrom y timeTo se ignoran. En otras palabras, el método funciona en dos modos. El primer modo requiere los valores de itemId, timeFrom, timeTo, format y compress en la solicitud. El segundo modo requiere los valores de layerName, format y compress en la solicitud.

Si la solicitud falla, se devuelve un código de error.