Получение рассылок

Получение рассылок

GET https://direct.i-dgtl.ru/api/v1/dispatch

Метод позволяет получить массив рассылок, подходящих под условия параметров.

Query Parameters

Name	Type	Description
created_from	string	Минимальная дата создания рассылки в формате yyyy-mm-ddThh:MM:ssZ
created_to	string	Максимальная дата создания рассылки
status	string	Статус рассылки
dispatch_id	integer	Идентификатор рассылки
dispatch_name	string	Название рассылки
traffic_center_id	integer	Идентификатор ЦРТ

Headers

Name	Type	Description
Authorization*	string	Basic {TOKEN_1}

200

{
  "total": 1,
  "items": [
    {
      "dispatchId": 1234,
      "dispatchName": "имя рассылки",
      "created": "2020-07-07T20:00:00Z",
      "localSendTime": "2020-07-08 10:00:00",
      "localCompletionTime": "2020-07-08 20:00:00",
      "useLocalTime": true,
      "status": "sending",
      "source": "sendername",
      "message": "текст сообщения",
      "trafficCenterId": 12,
      "trafficCenterName": "ЦРТ для рассылок",
      "base": {
        "included": {
          "type": "FILE",
          "name": "имя_файла.xlsx"
        },
        "excluded": {
          "type": "FILE",
          "name": "исключаемые_абоненты.xlsx"
        }
      },
      "parts": {
        "total": 1235,
        "delivered": 1000,
        "undelivered": 100,
        "unsent": 30,
        "sent": 45,
        "sending": 60
      },
      "messages": {
        "total": 1235,
        "delivered": 1000,
        "undelivered": 100,
        "unsent": 30,
        "sent": 45,
        "sending": 60
      }
    }
  ]
}

401

Использование невалидного токена.

4012

{
    "error": {
        "code": 4012,
        "msg": "Bad credentials"
    }
}

4010

{
    "error": {
        "code": 4010,
        "msg": "Not Authenticated"
    }
}

403

Использование неподходящего токена.

{
    "error": {
        "code": 4030,
        "msg": "Access Denied"
    }
}

Возможные варианты перечислений:

Параметр	Варианты
status	Статусы рассылок

Параметры объекта ответа

Параметр	Тип	Описание
total	integer	Количество найденных рассылок
items	array	Массив найденных рассылок
items.dispatchId	integer	Идентификатор рассылки
items.dispatchName	string	Название рассылки
items.created	string	Дата создания рассылки
items.localSendTime	string	Дата начала рассылки
items.localCompletionTime	string	Дата завершения рассылки
items.useLocalTime	boolean	Учитывается ли местное время получателей
items.status	string	Статус рассылки
items.source	string	Имя отправителя
items.message	string	Текст сообщения
items.trafficCenterId	integer	Идентификатор ЦРТ
items.trafficCenterName	string	Название ЦРТ
items.base	object	Информация об источнике получателей
items.base.included	object	Включенные получатели
items.base.included.type	string	Тип источника получателей MANUAL – ввод вручную FILE –импорт из файла API- создание через API
items.base.included.name	string	Имя файла
items.base.excluded	object	Исключенные получатели
items.base.excluded.type	string	Тип источника исключаемых получателей MANUAL – ввод вручную FILE –импорт из файла
items.base.excluded.name	string	Имя файла
items.parts	object	Статистика по частям сообщений рассылки
items.parts.total	integer	Общее количество частей
items.parts.delivered	integer	Доставлено частей
items.parts.undelivered	integer	Не доставлено частей
items.parts.unsent	integer	Не отправлено частей
items.parts.sent	integer	Отправлено частей; в ожидании статуса
items.parts.sending	integer	Частей в ожидании отправки
items.messages	object	Статистика по сообщениям рассылки
items.messages.total	integer	Общее количество сообщений
items.messages.delivered	integer	Доставлено сообщений
items.messages.undelivered	integer	Не доставлено сообщений
items.messages.unsent	integer	Не отправлено сообщений
items.messages.sent	integer	Отправлено сообщений; в ожидании статуса
items.messages.sending	integer	Сообщений в ожидании отправки

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

JSON

GET https://direct.i-dgtl.ru/api/v1/dispatch
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

cURL

curl --location 'https://direct.i-dgtl.ru/api/v1/dispatch' \
--header 'Content-Type: application/json'

Python

import requests
import json

url = "https://direct.i-dgtl.ru/api/v1/dispatch"

payload = {}
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

JavaScript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://direct.i-dgtl.ru/api/v1/dispatch", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://direct.i-dgtl.ru/api/v1/dispatch")
  .method("GET", body)
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

PHP

<?php
$client = new Client();
$headers = [
  'Content-Type' => 'application/json'
];
$request = new Request('GET', 'https://direct.i-dgtl.ru/api/v1/dispatch', $headers);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Go

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://direct.i-dgtl.ru/api/v1/dispatch"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}