# Примеры ## Обновление access token MyTarget ## /api/v2/my\_target/token `POST` `/api/v2/my_target/token` ``` HTTP Request: { "account_id":"account@mail.ru" } HTTP Response: { "code": 200, "message": "OK", "response": { "accessToken": } } ``` ## Обновление 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": , "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 | электронная почта управляющего | {% 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 `POST` `/api/v2/account/create` Создание рекламного аккаунта Google Ads #### Request Body | Name | Type | Description | | -------------------------------------------- | ------ | ------------------------- | | email\* | string | электронная почта (логин) | | time\_zone\* | 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, выбрать тип учетной записи “Рекламодатель” ( также он может самостоятельно заранее присоединиться к агентскому кабинету , но это не обязательно) 2. Предоставить тех поддержке callback url 3. Перенаправить пользователя из сервиса клиента на URL: `https://zaleycash.com/service/my_target/oauth2/?public_key=&user_id=&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`. Подробная инструкция приведена на странице в разделе “Описание сервиса” ## /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 | идентификатор аккаунта | {% tabs %} {% tab title="200: OK " %} ```javascript { // Response } ``` {% endtab %} {% endtabs %} ``` } "account_id":”account@mail.ru” } HTTP Response: { "code": 200, "message": "OK", "response": { "accessToken": } } ``` ## Создание аккаунта VK Клиенту API Zaleycash доступно добавление аккаунта VK в систему Zaleycash, для этого необходимо: 1. Предоставить тех поддержке callback url 2. Перенаправить пользователя из сервиса клиента на URL: `https://zaleycash.com/service/vk/oauth2/?public_key=&user_id=&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 ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://aloner26.gitbook.io/zc-apiv2-test/reference/zaleycash-api-v.2/primery.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.