ECIR API v1.0

Для получения ключа перейдите в профиль

Количество запросов ограничено до 50 на IP

Ответ возвращается в JSON

Чтобы создавать заказы у Вас должны быть средства на аккаунте

Партнёрская программа не применяется к заказам, сделанным с использованием API


Методы

Имя метода HTTP-метод Описание Обязательные параметры
Методы каталога
get-catalog GET Возвращает все позиции каталога key
get-product GET Возвращает запрошенную позицию каталога key product_id
Методы аккаунта
get-balance GET Возвращает баланс key
Методы заказов
get-status GET Возвращает статус запрошенного заказа key order_id
put-order PUT Создаёт заказ key, product_id, count, posts, url

Информация о параметрах

Параметр Тип Описание
key string Ваш ключ
product_id int ID продукта, полученный от get-catalog
order_id int Номер заказа, полученный от метода put-order
count int Количество лайков/подписчиков/и т.д.
posts int Количество постов. Применимо только к категории "Auto"
url string Ссылка для продвижения

Examples

get-catalog GET

Возвращает JSON с массивом продуктов

Сделайте GET запрос к https://ecir.ru/api/get-catalog

<?php
    $res = json_decode(file_get_contents('https://ecir.ru/api/get-catalog?' . http_build_query([
        'key' => 'YOUR_API_KEY',
    ])), false);

    foreach ($res as $value)
    {
        echo $value->title;
    }
?>
Пример ответа
[
    {
        "id":"<product_id>",
        "title":"<title>",
        "price":"<price>",
        "social":"<social>",
        "category":"<category>",
        "url_hint":"<url_hint>",
        "min_count":"<min>",
        "max_count":"<max>"
    },
    {
        ...
    }
]

get-product GET

Возвращает JSON с запрошенным продуктом

Сделайте GET запрос к https://ecir.ru/api/get-product

<?php
    $res = json_decode(file_get_contents('https://ecir.ru/api/get-product?' . http_build_query([
        'key' => 'YOUR_API_KEY',
        'product_id' => 1,
    ])), false);

    echo $res->title;
?>
Пример ответа
{
    "id":"<product_id>",
    "title":"<title>",
    "price":"<price>",
    "social":"<social>",
    "category":"<category>",
    "url_hint":"<url_hint>",
    "min_count":"<min>",
    "max_count":"<max>"
}

get-balance GET

Возвращает JSON с балансом

Сделайте GET запрос к https://ecir.ru/api/get-balance

<?php
    $res = json_decode(file_get_contents('https://ecir.ru/api/get-balance?' . http_build_query([
        'key' => 'YOUR_API_KEY',
    ])), false);

    echo $res->balance;
?>
Пример ответа
{"balance":"500"}

get-status GET

Возвращает JSON со статусом заказа

Сделайте GET запрос к https://ecir.ru/api/get-status

<?php
    $res = json_decode(file_get_contents('https://ecir.ru/api/get-balance?' . http_build_query([
        'key' => 'YOUR_API_KEY',
        'order_id' => 123,
    ])), false);

    echo $res->order_id;
    echo $res->status;
    echo $res->remains;
?>
Пример ответа
{"order_id":"8374", "status":"Completed", "remains":"0"}

put-order PUT

Возвращает JSON с номером заказа

Сделайте PUT запрос к https://ecir.ru/api/put-order

<?php
    $ch = curl_init();

    curl_setopt($ch, CURLOPT_URL, 'https://ecir.ru/api/put-order');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
        'url' => $url,
        'count' => $count,
        'posts' => $posts,
        'product_id' => $product_id,
        'key' => $key,
    ]));

    $response = curl_exec($ch);

    if ($response)
    {
        echo $response;
    }
?>
Пример ответа
{"order_id":"8374"}