• Главная
• Ресурсы
• Документация
• API
• register

Метод register

Метод позволяет зарегистрировать нового пользователя. Полезен для партнёрских сайтов, желающих создать свою собственную страницу регистрации. Регистрируемый пользователь автоматически закрепляется за партнёром.

Предполагается, что партнёр, использующий этот метод, сделал защиту от множественных и фальшивых регистраций методом CAPTCHA или подобным, и получил согласие пользователя с нашими условиями оказания услуг.

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

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

extra[firstname]=Alex&extra[company]=Firm

Смотрите также

• getUserInfo
• validateSender
• transferMoney

Примеры на PHP

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

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

// Обязательные параметры нового пользователя
$new_login = "new_user_login";
$new_email = "new_user_email@yandex.ru";

// Необязательные, но желателтные параметры нового пользователя
// Если файл скрипта в кодировке UTF-8, то уберите все вызовы iconv
$new_password = "8gHj2hGhsj3";
$new_country= "FRA";
$new_firstname = iconv('cp1251', 'utf-8', "Иван");
$new_lastname = iconv('cp1251', 'utf-8',"Иванов");
$new_company = iconv('cp1251', 'utf-8',"ООО Ромашка");
$new_phone = iconv('cp1251', 'utf-8',"(499) 123-4567");
$new_timezone = iconv('cp1251', 'utf-8',"Europe/Moscow");
$new_currency = "EUR";

// Создаём POST-запрос
$POST = array (
  'api_key' => $api_key,
  'login' => $new_login,
  'email' => $new_email,
  'password' => $new_password,
  'extra[firstname]' => $new_firstname,
  'extra[lastname]' => $new_lastname,
  'extra[company]' => $new_company,
  'extra[phone]' => $new_phone,
  'timezone' => $new_timezone,
  'country_code' => $new_country,
  'currency_code' => $new_currency
);

// Устанавливаем соединение
$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, 
            'http://api.unisender.com/ru/api/register?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 {
    // Новый пользователь успешно создан
    echo "New user is created. User API_Key is: " . $jsonObj->result->api_key;

  }
} else {
  // Ошибка соединения с API-сервером
  echo "API access error";
}

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

// Обязательные параметры для созданиянового пользователя
$new_login = "new_user_login";
$new_email = "new_user_email@yandex.ru";

// Необязательные (но желательтные) параметры для создания нового пользователя
// Если файл скрипта в кодировке UTF-8, то уберите все вызовы iconv
$new_password = "8gHj2hGhsj3";
$new_country = "RUS";
$new_firstname = urlencode(iconv('cp1251', 'utf-8', "Иван"));
$new_lastname = urlencode(iconv('cp1251', 'utf-8',"Иванов"));
$new_company = urlencode(iconv('cp1251', 'utf-8',"ООО Ромашка"));
$new_phone = urlencode(iconv('cp1251', 'utf-8',"(499) 123-4567"));
$new_timezone = urlencode(iconv('cp1251', 'utf-8',"Europe/Moscow"));
$new_currency = "RUB";


// Создаём GET-запрос
$api_url = "http://api.unisender.com/ru/api/register?format=json".
           "&api_key=$api_key&login=$new_login&email=$new_email".
           "&password=$new_password&extra[firstname]=$new_firstname".
           "&extra[lastname]=$new_lastname&extra[company]=$new_company".
           "&extra[phone]=$new_phone&timezone=$new_timezone".
           "&country_code=$new_country¤cy_code=$new_currency";

// Делаем запрос на 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 {
    // Новый пользователь успешно создан
    echo "New user is created. User API_Key is: " . $jsonObj->result->api_key;
  }

} else {
  // Ошибка соединения с API-сервером
  echo "API access error";
}