REST API Маркетгид для рекламных агентств

REST API Маркетгид для рекламных агентств

Регистрация клиента РА

Метод POST
URL api.marketgid.com/v1/clients/

Передаваемые параметры:

Параметр Значение
token token пользователя
email email нового пользователя
manager Хеш, который указывает, какого куратора проставить по всем направлениям создаваемому клиент

Хеш для регистрации клиентов можно посмотреть в Профиле РА в админке.

Возвращаемый ответ:

Возможные ошибки:

При использовании параметра manager у куратора(РА) должна быть установлена валюта и менеджер сопровождения.

Получение токена РА

Метод POST
URL api.marketgid.com/v1/auth/agencies-token

Передаваемые параметры:

Параметр Значение
login Логин, под которым Рекламное агентство зарегистрировано в системе Маркетгид
password Пароль Рекламного агентства, с которым входит в систему

Возвращаемый ответ:

_текущий_токен_ используется для идентификации РА; _токен_для_обновления_ - будет использован в последующих версиях для обновления просроченного текущего токена.

Возможные ошибки:

Если такого логина нет в системе, возвращает ошибку "Такого логина в системе нет";

Если введен не верный пароль, возвращает ошибку "Вы ввели неверный пароль."

Получение списка клиентов РА с состоянием счетов

Метод GET
URL api.marketgid.com/v1/agencies/{authId}/clients?token={token}

Передаваемые параметры:

Параметр Значение
authId Идентификатор учетной записи Рекламного агенства
token Текущий токен доступа

В случае успеха возвращаются данные в таком виде:

Все суммы передаются в валюте клиента (РА).

Возможные ошибки:

Если токен, передаваемый РА не действительный, возвращаем ошибку "Токен не действительный".

Получение состояний счетов одного клиента по id

Метод GET
URL api.marketgid.com/v1/agencies/{authId}/clients/{client_id}?token={token}

Передаваемые параметры:

Параметр Значение
authId Идентификатор учетной записи  Рекламного агенства
token Текущий токен доступа
client_id id клиента РА

В случае успеха возвращаются данные в таком виде:

Все суммы передаются в валюте клиента (РА).

Возможные ошибки:

Если токен, передаваемый РА не действительный, возвращаем ошибку "Токен не действительный";

Если введенный id клиента не существует в системе или не является клиентом этого РА, возвращаем ошибку "Указан неверный id клиента".

Получение информации о состоянии счетов РА

Метод GET
URL api.marketgid.com/v1/agencies/{authId}?token={token}

Передаваемые параметры:

Параметр Значение
authId Идентификатор учетной записи Рекламного агенства
token Текущий токен доступа

В случае успеха возвращаются данные в таком виде:

Все суммы передаются в валюте РА.

Возможные ошибки:

Если токен, передаваемый РА не действительный, возвращаем ошибку "Токен не действительный";

Получение данных по тратам клиентов РА за период

Метод GET
URL api.marketgid.com/v1/agencies/{authId}/clients-spent-reports?token={token}

Передаваемые параметры:

Параметр Значение
authId Идентификатор учетной записи Рекламного агенства
token Текущий токен доступа
dateStart Дата начала интервала в формате YYYY-MM-DD
dateEnd Дата окончания интервала в формате YYYY-MM-DD
clientsIds значения id клиентов через запятую, не обязательный параметр

В случае успеха возвращаются данные в таком виде:

Все суммы передаются в валюте РА.

Если параметр clientsIds передан пустым, то выдается отчет по всем клиентам РА.

Возможные ошибки:

Если токен, передаваемый РА не действительный, возвращаем ошибку "Токен не действительный";

Если введенный id клиента не существует в системе или не является клиентом этого РА, возвращаем ошибку "Указан неверный id клиента";

Ошибки правильности формата параметров: даты должны быть в формате YYYY-MM-DD, clientsIds клиентов должны быть через запятую.

Пополнение баланса клиента со счетов РА

Метод POST
URL api.marketgid.com/v1/agencies/{authId}/clients/{id клиента}/money-transfers?token={token}&account_type={account_type}&transfer_amount={transfer_amount}

Передаваемые параметры:

Параметр Значение
authId Идентификатор учетной записи Рекламного агенства
token Текущий токен доступа
client_id id клиента РА
account_type Счет, с которого будут списаны деньги, может принимать только одно из значений: personal или bonus
transfer_amount сумма пополнения в валюте РА, число

В случае успеха возвращаются данные в таком виде:

Все суммы передаются в валюте РА.

Возможные ошибки:

1) Если у РА денег на указанном счете не хватает, сумма введенная в переданных данных больше, чем на указанном кошельке, то возвращаем ошибку "Сумма денег на счету меньше, чем вы пытаетесь перевести".

2) Если токен не действителен, возвращаем ошибку "Токен не действительный".

3) Если такого id клиента нет в системе или указанного id куратором стоит не это РА, возвращаем ошибку "Указан не верный id клиента"

4) Если не указан счет, клиенты, сумма переводов, возвращаем ошибку "Не указан(а) счет (клиент, сумма) для перевода денег"

Похожие статьи

Типы лендингов

Чтобы достигнуть оптимального баланса между интересами рекламодателей, запросами вебмастеров и пользовательским опытом, мы представляем...

Read More