Запрос на экспорт необработанных данных

Создайте запрос на экспорт необработанных данных в CSV-файлы.

Входные данные

POST https://tracker.my.com/api/raw/v1/export/create.json

Параметры

* — обязательные параметры

** — обязательно наличие хотя бы одной пары параметров: dateFrom и dateTo или tsFrom и tsTo

Пример запроса

Выгрузка данных по платежам в период с 2017-11-02 по 2017-11-30 в часовом поясе Europe/Moscow по заданным селекторам:

/api/raw/v1/export/create.json?event=payments&selectors=idCountry,waid,idAccount,iosVendorId&dateTo=2017-11-30&dateFrom=2017-11-02&timezone=Europe/Moscow

Форматы ответа

В случае успеха

Если запрос создан успешно, вы получите код ответа 200. Идентификатор запроса будет указан в поле idRawExport:

{
  "code": 200,
  "message": "Ok",
  "data": {
    "idRawExport": "2"
  }
}

Ошибки

При ошибках в передаваемых параметрах вы получите код ответа 400. Например:

• Неправильно передан тип выгружаемого события — event

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Argument 'event' must be in set of allowed tables. Allowed values are: install, payment, launch, customEvent."
      }
    }
  }

• Не передан обязательный параметр

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Argument 'event' is expected but not set"
      }
    }
  }

• Запрос недоступного или несуществующего селектора.

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Argument 'selectors' is invalid"
      }
    }
  }

• Выгрузка необработанных данных из аккаунта недоступна, так как пользователю не выдано разрешение на выгрузку.

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Export permissions required to export raw data from an account"
      }
    }
  }

Ограничения

• Данный метод требует авторизации. Вы получите код ответа 403, если сделаете запрос с невалидной авторизацией или не передадите её совсем.

  {
    "code": 403,
    "message": "Access denied",
    "data": null
  }

• Количество одновременно выполняемых запросов ограничено. При превышении допустимого числа запросов вы получите код ответа 400:

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Maximum number of simultaneous requests reached. Wait until there is space available in the queue.",
        "info": {
          "exports": [
            {
              "idRawExport": "2"
            }
          ]
        }
      }
    }
  }

• В одном фильтре можно передать не более 1000 значений. Если у вас несколько фильтров, то в каждом из них можно передать максимум по 1000 значений. В случае, если превышено максимальное количество значений, вы получите код ответа 400:

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Argument 'idCampaign' set size expected to be below 1000",
      }
    }
  }