Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод getUsers

Метод для получения информации о пользователях прикреплённых к партнёру.

Данный метод работает только для аккаунтов, имеющих статус реселлера.

Принцип использования

Синтаксис и URL для вызова метода
getUsers ([datetime registered_after])
https://api.unisender.com/ru/api/getUsers?format=json&api_key=KEY&registered_after=REGISTEREDAFTER&registered
_before=REGISTEREDBEFORE
Аргументы
api_key * Ключ доступа к API
registered_after Дата и время после которой зарегистрировались пользователи в формате «ГГГГ-ММ-ДД чч:мм».
registered_before Дата и время до которой зарегистрировались пользователи в формате «ГГГГ-ММ-ДД чч:мм».
Возвращаемое значение
JSON-массив, каждый элемент массива – объект с полями, аналогичными тем, что возвращает метод getUserInfo.

Пример возвращаемого значения:

{
  "result":[
    {
        "login":"test_user_login",
        "email":"test@test.com",
        "firstname":"test name",
        "middlename":"test name",
        "lastname":"test name",
        "reg_time":"2011-09-05 10:00:00",
        "phone":"+70000000000",
        "company":"test company",
        "channel":"test channel",
        "timezone":"Europe/Moscow",
        "master":"test_main_login",
        "balance":18.52,
        "balance_bonus":0,
        "currency":"USD",
        "emails_paid":0,
        "emails_used":40734,
        "period_emails_paid":1000,
        "period_emails_used":0,
        "email_period_start":"2011-01-03 00:46:02",
        "email_period_end":"2011-02-03 00:46:02",
        "tariff_id":1,
        "next_tariff_id":10,
        "services": [{id:234, tariff:"bitrix24_premium_3m", paidUntil:"2017-04-28 10:51:33"}], 
        "is_active":1,
        "reg_ref":"https://www.facebook.com/",
        "reg_url":""https://unisender.test.ru/ru/v5/two_step_register",
        "api_mode":"on",
        "subscribers_total": 500,
        "subscribers_used": 129 
   } 
  ] 
}

Примеры на PHP

Мы настоятельно рекомендуем использовать POST-запросы, так как это более безопасный метод передачи данных, нежели GET. Используйте SSL-соединение с UniSender. Подробнее о методах соединения здесь.

Пример с использованием POST-запроса

// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxxxxxxxxxxx";

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
);

// Устанавливаем соединение
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $POST);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_URL,
            'https://api.unisender.com/ru/api/getUsers?format=json');
$result = curl_exec($ch);

if ($result) {
  // Раскодируем ответ API-сервера
  $jsonObj = json_decode($result);

  if(null===$jsonObj) {
    // Ошибка в полученном ответе
    echo "Invalid JSON";

  }
  elseif(!empty($jsonObj->error)) {
    // Ошибка получения списка пользователей
    echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";

  } else {
    // Выводим логины и email пользователей
    echo "Here's a list of your users:
"; foreach ($jsonObj->result as $one) { echo "User " . $one->login . " (" . $one->email . ")". "
"; } } } else { // Ошибка соединения с API-сервером echo "API access error"; }

Пример с использованием GET-запроса

// Ваш ключ доступа к API (из Личного Кабинета)
$api_key = "xxxxxxxxxxxxxxxx";

// Создаём GET-запрос
$api_url = "https://api.unisender.com/ru/api/getUsers?format=json&api_key=$api_key";

// Делаем запрос на API-сервер
$result = file_get_contents($api_url);

if ($result) {
  // Раскодируем ответ API-сервера
  $jsonObj = json_decode($result);

  if(null===$jsonObj) {
    // Ошибка в полученном ответе
    echo "Invalid JSON";

  }
  elseif(!empty($jsonObj->error)) {
    // Ошибка получения списка пользователей
    echo "An error occured: " . $jsonObj->error . "(code: " . $jsonObj->code . ")";

  } else {
    // Выводим логины и email пользователей
    echo "Here's a list of your users:
"; foreach ($jsonObj->result as $one) { echo "User " . $one->login . " (" . $one->email . ")". "
"; } } } else { // Ошибка соединения с API-сервером echo "API access error"; }