# Примеры

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

## /api/v2/my\_target/token

<mark style="color:green;">`POST`</mark> `/api/v2/my_target/token`&#x20;

```
HTTP Request:
{
	"account_id":"account@mail.ru"
}

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

## Обновление access token VK advert&#x20;

## /api/v2/vk\_advert/token

<mark style="color:green;">`POST`</mark> `/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

<mark style="color:green;">`POST`</mark> `/api/v2/account/create`&#x20;

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

#### Request Body

| Name                                            | Type        | Description                                             |
| ----------------------------------------------- | ----------- | ------------------------------------------------------- |
| service<mark style="color:red;">\*</mark>       | string      | сеть                                                    |
| name<mark style="color:red;">\*</mark>          | string      | наименование                                            |
| time\_zone<mark style="color:red;">\*</mark>    | string      | часовой пояс                                            |
| customer<mark style="color:red;">\*</mark>      | string      | юр. название компании                                   |
| category<mark style="color:red;">\*</mark>      | external id | сфера деятельности ( идентификатор категории в tik tok) |
| country<mark style="color:red;">\*</mark>       | code alpha2 | страна регистрации юр. лица (в коде alpha2)             |
| promo\_link<mark style="color:red;">\*</mark>   | link        | ссылка на рекламируемый продукт                         |
| email\_member<mark style="color:red;">\*</mark> | string      | электронная почта управляющего                          |

{% tabs %}
{% tab title="200: OK " %}

{% endtab %}
{% endtabs %}

```
{
	"service":"tiktok",
	"name":"AccountName",
        "time_zone":"Europe/Samara",
	"customer":"SpecialToys LLC",
	"category":"291306",		
	"country":"RU",			
	"promo_link":"http://specialtoys.com",
	"email_member":"manager@specialtoys.com"
}
```

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

## /api/v2/account/create

<mark style="color:green;">`POST`</mark> `/api/v2/account/create`&#x20;

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

#### Request Body

| Name                                         | Type   | Description               |
| -------------------------------------------- | ------ | ------------------------- |
| email<mark style="color:red;">\*</mark>      | string | электронная почта (логин) |
| time\_zone<mark style="color:red;">\*</mark> | valie  | часовой пояс              |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

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

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

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

1. Сообщить юзеру, что он должен самостоятельно зарегистрироваться в MyTarget, выбрать тип учетной записи “Рекламодатель” ( также он может самостоятельно заранее присоединиться к агентскому кабинету <mt_rub@zaleycash.com> , но это не обязательно)
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;

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

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

## /api/v2/my\_target/token

<mark style="color:green;">`POST`</mark> `/api/v2/my_target/token`&#x20;

**Обновить access token MyTarget**

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

#### Request Body

| Name                                          | Type   | Description            |
| --------------------------------------------- | ------ | ---------------------- |
| account\_id<mark style="color:red;">\*</mark> | string | идентификатор аккаунта |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

```
}
	"account_id":”account@mail.ru”
}
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
```