Request to export raw data

Create a request to export raw data to CSV files.

Input data

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

Parameters

* — required parameters

* — require at least one pair of parameters: dateFrom and dateTo or tsFrom and tsTo

Example query

Use the create method to export payments data from 2017-11-02 to 2017-11-30 in the Europe/Moscow timezone with the selectors:

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

Responses

Success

A 200 status code indicates success. It will include an identifier of a new request in the idRawExport field:

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

Errors

A 400 status code indicates an error in parameters given. For example:

• Invalid event type

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

• Missing parameter

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

• Invalid selector.

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

• Raw data cannot be exported from an account because export permissions are not granted to a user.

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

Restrictions

• A 403 status code indicates that the method needs authorization. Maybe you made mistakes or forgot to send authorization data.

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

• A 400 status code is returned when you sent a new request and exceeded the limit of request in a queue:

  {
    "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"
            }
          ]
        }
      }
    }
  }

• A 400 status code is returned when a maximum of values exceeds in a filter. A request has a length limit that means that in one filter, you can pass a maximum of 1000 values. If you have several filters, then you can pass a maximum of 1000 values in each.

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