Примеры

примеры запросов

Обновление access token MyTarget

/api/v2/my_target/token

POST /api/v2/my_target/token

HTTP Request:
{
	"account_id":"[e-mail]"
}

HTTP Response:
{
    "code": 200,
    "message": "OK",
    "response": {
        "accessToken": <string>
    }
}  

Обновление access token VK advert

/api/v2/vk_advert/token

POST /api/v2/vk_advert/token

HTTP Request:
{
	"account_id": "account_name_vk"
}

HTTP Response:
{
    "code": 200,
    "message": "OK",
    "response": {
        "accessToken": <string>,
        "expiresIn": int
    }
}

Создание рекламного аккаунта Tik Tok

/api/v2/account/create

POST /api/v2/account/create

Создание рекламного аккаунта Tik Tok

Request Body

Name	Type	Description
service*	string	сеть
name*	string	наименование
time_zone*	string	часовой пояс
customer*	string	юр. название компании
category*	external id	сфера деятельности ( идентификатор категории в tik tok)
country*	code alpha2	страна регистрации юр. лица (в коде alpha2)
promo_link*	link	ссылка на рекламируемый продукт
email_member*	string	электронная почта управляющего

200: OK

{
	"service":"tiktok",
	"name":"AccountName",
        "time_zone":"Europe/Samara",
	"customer":"SpecialToys LLC",
	"category":"291306",		
	"country":"RU",			
	"promo_link":"http://specialtoys.com",
	"email_member":"[e-mail]"
}

Создание рекламного аккаунта Google Ads

/api/v2/account/create

POST /api/v2/account/create

Создание рекламного аккаунта Google Ads

Request Body

Name	Type	Description
email*	string	электронная почта (логин)
time_zone*	valie	часовой пояс

200: OK

{
    // Response
}

{
	"service":"google",
	"email":"AccountName",
        "time_zone":"Europe/Samara"
}

Создание рекламного аккаунта MyTarget (виртуального)

Клиенту API Zaleycash доступно добавление аккаунта MyTarget в систему Zaleycash, для этого необходимо:

1. Сообщить юзеру, что он должен самостоятельно зарегистрироваться в MyTarget, выбрать тип учетной записи “Рекламодатель” ( также он может самостоятельно заранее присоединиться к агентскому кабинету [e-mail] , но это не обязательно)

2. Предоставить тех поддержке callback url

3. Перенаправить пользователя из сервиса клиента на URL: https://zaleycash.com/service/my_target/oauth2/?public_key=<public_key>&user_id=<user_id>&data=<data>

public_key валиден всегда и выдается клиенту один раз по запросу

User_id необходимо запросить у вашего менеджера, это айди пользователя в залейкеш Data - это свободное значение, которое вы можете передать и оно же в том же виде вернется вам на callback url

1. После подтверждения доступа к аккаунту, пользователь будет перенаправлен на специальный URL, который заранее определен клиентом API Zaleycash. В URL будет передан параметр status, содержащий статус выполнения операции добавления аккаунта в Zaleycash.com. Возможные статусы:

2. 1. ok - операция выполнена корректно;

   2. error - внутренняя ошибка при добавлении аккаунта;

   3. error_token - не удалось получить токен пользователя в API MyTarget;

А также параметр account_id в случае status=ok/updated, и ваше значение data.

Подробная инструкция приведена на странице https://zaleycash.com/service/my_target/ в разделе “Описание сервиса”

/api/v2/my_target/token

POST /api/v2/my_target/token

Обновить access token MyTarget

ZaleyCash предоставляет прямой доступ к клиентским методам API MyTarget по токену. Токен действителен в течение часа после чего необходимо выполнить его обновление с помощью данного метода

Request Body

Name	Type	Description
account_id*	string	идентификатор аккаунта

200: OK

{
    // Response
}

}
	"account_id":”[e-mail]”
}
HTTP Response:
{
    "code": 200,
    "message": "OK",
    "response": {
        "accessToken": <string>
    }
}

Создание аккаунта VK

Клиенту API Zaleycash доступно добавление аккаунта VK в систему Zaleycash, для этого необходимо:

1. Предоставить тех поддержке callback url

2. Перенаправить пользователя из сервиса клиента на URL: https://zaleycash.com/service/vk/oauth2/?public_key=<public_key>&user_id=<user_id>&data=<data>

public_key валиден всегда и выдается клиенту один раз по запросу

User_id необходимо запросить у вашего менеджера, это айди пользователя в залейкеш Data - это свободное значение, которое вы можете передать и оно же в том же виде вернется вам на callback url

1. После подтверждения доступа к аккаунту пользователь будет перенаправлен на специальный URL, который заранее определен клиентом API Zaleycash. В URL будет передан параметр status, содержащий статус выполнения операции добавления аккаунта в Zaleycash.com. Возможные статусы:

2. 1. ok - операция выполнена корректно;

   2. error - внутренняя ошибка при добавлении аккаунта;

   3. error_token - не удалось получить токен пользователя в API VK;

   4. updated - обновлен токен действующего аккаунта;

   А также параметр account_id в случае status=ok/updated, и ваше значение data