Описание.

API построено по принципу REST. На данный момент реализованы следующие ресурсы: domain (работа с доменными именами), contact (работа с контактами доменов) и balance (проверка баланса пользователя).

Endpoint для отправки запросов: https://parkovka.ua/api/v1/

Для ресурса domain предусмотрены следующие методы: GET, POST, PUT;
Для ресурса contact предусмотрены следующие методы: GET, POST, PUT;
Для ресурса balance предусмотрены следующие методы: GET

Все запросы к API требуют авторизацию пользователя на сервисе. Авторизация происходит посредством логина и пароля который задан при регистрации на сервисе. Для методов POST, PUT так же необходимо указывать токен который генерируется при авторизации на сервисе.

Токен передается в заголовке запроса X-CSRF-Token.

Быстрый старт.

Удобным способом начать работу с API будет использование класса parkovka_api_class который можно скачать по ссылке.  Скачав класс можно будет посмотреть пример реализации взаимодействия с API Parkovka.ua.

Пример взаимодействия с API Parkovka.ua

require 'parkovka_api.class.php'; // подключаем класс

$api = new parkovka_api_client('https://parkovka.ua/api/v1'); // создаем объект класса указав endpoint текущей версии API

$api->login('login','password'); // авторизируемся на сервисе используя свой логин и пароль

/*
после авторизации для объекта $api доступны следующие методы
create (POST) для создания ресурса,
retrieve (GET) для получения информации о ресурсе,
update (PUT) для обновления ресурса,
delete (DELETE) для удаления ресурса,
index (GET) для получения списка доступных ресурсов,
action (POST) для действий над ресурсами
*/

$index = $api->index('domain'); // получаем список доменов из аккаунта пользователя посредством метода index

// Ответ сервера содержит объект со списком доменов данного пользователя.

$first_domain = $index->response->domains[0]->domain; // получаем первое доменное имя из списка

$info = $api->retrieve('domain',$first_domain); //  получаем данные о домене

// Ответ сервера содержит объект с данными домена, его дату регистрации, дату окончания, статус и текущие name-сервера

$data = array(
  'ns' => array(
    'ns.master.parkovka.ua',
    'ns.parkovka.ua',
    'ns.parkovka.ua',
  )
);

$update = $api->update('domain',$first_domain,$data); // обновим name-сервера домена

// Ответ сервера содержит объект с данными домена, его дату регистрации, дату окончания, статус и текущие name-сервера

$api->logout();