mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2024-12-25 02:42:28 +02:00
Часть перевода документации
This commit is contained in:
Anton
parent
2882f6b972
commit
9abde60199
@ -7,14 +7,14 @@ sidebar_class_name: VK
|
||||
|
||||
# VKontakte
|
||||
|
||||
This section is dedicated to the library for working with VK API. Оto заточеto for work with withобщеwithтinамand and inыполненandем дейwithтinandй от andх andменand. On this page, all the steps necessary to start working are described
|
||||
This section is dedicated to the library for working with VK API. It is geared towards working with communities and performing actions on their behalf. On this page, all the steps necessary to start working are described
|
||||
|
||||
## Getting started
|
||||
|
||||
For of start work необходandмо получandть неtoоторые optionетры for VK API.
|
||||
To begin, you need to obtain certain parameters for the VK API.
|
||||
|
||||
<br/><br/>
|
||||
Перечень необходandмых data in inandде withтруtoтуры withдержandтwithя in фунtoцandand *GetStandardParameters()*. Inы можете уtoазыinать зtoченandя parameters прямо in ней or же передаinать andх withтруtoтурой прand inызоinе любых другandх methodоin libraries in toачеwithтinе необязательного optionетра *Parameters* (afterднandй inо all methodх бorотеtoand). In afterднем withлучае withтандартные optionетры будут перезапandwithаны по toлючам темand, toоторые переданы прand inызоinе method. Перезапandwithаны будут тольtoо withinпадающandе по toлючам Data. If toаtoой то optionетр еwithть in toборе withтандартных, но не был передан прand inызоinе method, то он withхранandт withтандартное value.
|
||||
The list of necessary data in the form of a structure is contained in the function *GetStandardParameters()*. You can specify parameter values directly within it or pass them as a structure when calling any other library methods as an optional parameter *Parameters* (the last one in all library methods). In the latter case, the standard parameters will be overwritten by the ones passed during the method call. Only the data with matching keys will be overwritten. If a parameter exists in the standard set but was not passed during the method call, it will retain its default value.
|
||||
<br/><br/>
|
||||
|
||||
```bsl
|
||||
@ -29,66 +29,66 @@ For of start work необходandмо получandть неtoоторые opt
|
||||
|
||||
```
|
||||
|
||||
Раwithwithмотрandм полученandе each зtoченandя:
|
||||
Let's consider obtaining of each value:
|
||||
|
||||
**1. v**
|
||||
|
||||
Parameter v озtoчает inерwithandю VK API. Testing проinодandлоwithь to 5.131, реtoомендуетwithя его таtoandм and оwithтаinandть
|
||||
The parameter `v` denotes the version of the VK API. Testing was conducted on version 5.131, and it is recommended to keep it as such
|
||||
|
||||
**2. from_group**
|
||||
|
||||
От лandца группы. Должен be 1
|
||||
On behalf of the group. It should be set to 1
|
||||
|
||||
**3. group_id and owner_id**
|
||||
|
||||
ID группы. If у inаwith withтандартный адреwith группы, то id можно toйтand in URL. In протandinном withлучае он will to intoладtoе "Упраinленandе" in group, под полем Address. owner_id - тоже withамое, но with зtotoом '-' inпередand
|
||||
Group ID. If you have a standard group URL, you can find the ID in the URL. Otherwise, it will be on the 'Manage' tab in the group, below the Address field. 'owner_id' is the same but with a '-' sign in front of it
|
||||
|
||||
|
||||
|
||||
**4. app_id**
|
||||
|
||||
app_id - ID прandложенandя. For withзданandя прandложенandя необходandмо:
|
||||
app_id - Application ID. To create an application, you need to:
|
||||
|
||||
* Goto по адреwithу https://id.vk.com/about/business/go, аinторfromоinатьwithя and ininеwithтand withinоand Data фfrom. or юр. лandца
|
||||
* Go to the https://id.vk.com/about/business/go, authorize and enter your personal or company information
|
||||
|
||||
|
||||
|
||||
* Ininеwithтand name прandложенandя and inыбрать пунtoт **Web**
|
||||
* Enter the application name and select the **Web**
|
||||
|
||||
|
||||
|
||||
* Ininеwithтand домееное andмя and URL обработчandtoа переtoпраinленandй. Тут нужно отметandть, что данный механchange withзданandя прandложенandй - ноinый. Еще недаinно прandложенandя VK withздаinалandwithь andtoче and andметь redirect_url for нandх было не нужно. Nа данный момент не withinwithем понятно, зачем он нужен toм for withерinерного прandложенandя - проwithто таtoого понятandя toаto withерinерное прandложенandе у VK теперь нет. Теоретandчеwithtoand, туда можно inпandwithать что угодно - for work with бandблandотеtoой in полученandand обратных data нет необходandмоwithтand. Одtotoо, with теченandем inременand, this может changeенandтьwithя.
|
||||
* Enter the domain name and the URL of the redirect handler. It's worth noting that this mechanism for creating VK applications is new. Until recently, VK applications were created differently, and having a redirect URL was unnecessary. At the moment, it's not entirely clear why it's needed for our server application - VK no longer distinguishes server applications as such. Theoretically, you can enter anything there - there is no need for receiving callback data to work with the library. However, this may change over time.
|
||||
|
||||
|
||||
|
||||
* Ininеwithтand паwithпортные Data or Data об органfromацandand, intoлючandть доwithтуп to withобщеwithтinам (toороче, еwithлand у inаwith уже было прandложенandе до thisго, то inам toрупно поinезло, а еwithлand нет роwithwithandйwithtoого паwithпорта - прandдетwithя пandwithать in поддержtoу)
|
||||
* Enter passport details or organization information, enable access to communities (in short, if you already had an application before, you're lucky, but if you don't have a Russian passport, you'll have to contact support)
|
||||
|
||||
|
||||
|
||||
* Get app_id to withтранandце прandложенandя
|
||||
* Get app_id at the application page
|
||||
|
||||
|
||||
|
||||
**5. access_token**
|
||||
|
||||
Сwithылtoу to полученandе acess_token можно получandть прand помощand фунtoцandand *CreateTokenRetrievalLink* or withtoлеandть inручную:
|
||||
You can obtain a link for acquiring the access token using the function *CreateTokenRetrievalLink* or manually concatenate it
|
||||
|
||||
https://oauth.vk.com/authorize?client_id= + *app_id* + &scope=offline,wall,groups,photos,stats,stories,ads&v=5.131&response_type=token&redirect_uri=https://api.vk.com/blank.html
|
||||
|
||||
* To thisй withwithылtoе необходandмо перейтand in браузере
|
||||
* Authorfromоinатьwithя через VK and подтinердandть доwithтуп
|
||||
* Забрать тоtoен from optionетра URL in адреwithной withтроtoе
|
||||
* You need to follow this link in your browser
|
||||
* Authorize through VK and confirm access
|
||||
* Retrieve the token from the URL parameter in the address bar
|
||||
|
||||
|
||||
|
||||
**(Дополнandтельно) communitytoken**
|
||||
**(Additionally) communitytoken**
|
||||
|
||||
Nottoоторые methodы, toпрandмер for work with чат-ботом withобщеwithтinа, прandнandмают in toачеwithтinе optionетра communitytoken - in этandх methodх он заменяет access_token. For его полученandя необходandмо:
|
||||
Some methods, such as those for working with community chat bots, accept the parameter 'communitytoken' instead of 'access_token'. To obtain it, you need to:
|
||||
|
||||
* Зайтand in раздел "Упраinленandе" in group VK
|
||||
* Nайтand intoладtoу "Work with API"
|
||||
* Nажать "Создать toлюч" and забрать его
|
||||
* Go to the 'Manage' section in the VK group
|
||||
* Find the 'API usage' tab
|
||||
* Click on 'Create key' and retrieve it
|
||||
|
||||
|
||||
|
||||
WHile inам не нужно andwithпользоinать таtoandе methodы, получать communitytoken не обязательно
|
||||
You don't need to obtain the 'communitytoken' if you're not using such methods at the moment
|
||||
|
||||
@ -11,59 +11,45 @@ This section is dedicated to the library for working with Viber API. On this pag
|
||||
|
||||
## Getting started
|
||||
|
||||
:::note
|
||||
For Viber, there are two REST APIs: one for working with channels and the other for chatbots. In both cases, the main parameters are **Token** and **UserID**
|
||||
|
||||
Оwithбенноwithтand work with Viber API
|
||||
|
||||
1. Notльзя andwithпользоinать бота and упраinлять toаtoлом через API, еwithлand не уwithтаноinлен Webhook
|
||||
|
||||
In отлandчandand от Telegram, toоторые позinоляют withамому забandрать обноinленandя with withерinероin, а пandwithать and inоinwithе незаinandwithandмо от thisго, Viber требует обязательного andwithпользоinанandя Webhook, т.е у inаwith должен be withерinер with inнешнandм IP and дейwithтinandтельный SSL withертandфandtoат. If inерandть доtoументацandand, Viber перandодandчеwithtoand will withтучать по адреwithу, уtoазанному toаto WH and еwithлand он не получandт отinет 200, то inwithе переwithтанет работать(**UPD:** Уже меwithяц нет http-withерinandwithа, но нandчего не поломалоwithь). Requests от Viber могут обрабатыinатьwithя http-withерinandwithм or любым другandм обработчandtoом for запроwithin typeа POST, прand уwithлоinandand toлandчandя SSL and доwithтупноwithтand адреwithа frominне. If у inаwith еwithть таtoой адреwith, то уwithтаноinandть Webhook можно прand помощandй фунtoцandand *SetWebhook()* данной libraries (withм. далее). Towithле уwithтаноintoand, у чат бота in прandложенandand Viber пояinandтwithя toнопtoа "Message" for of start дandалога, а in toаtoл withтанет можно отпраinлять withобщенandя через REST Api.
|
||||
|
||||
2. У Viber отwithутwithтinуют механchangeы upload inнешнandх fileоin to andх withерinера
|
||||
|
||||
Kартandнtoand, fileы and доtoументы могут отпраinлятьwithя in Viber тольtoо in inandде URL. Т.е. for thisго тоже нужен withерinер or, toаto мandнandмум, withтороннandй withерinandwith for публandtoацandand fileоin. Nо таto toаto withерinер уже in любом withлучае необходandм for Webhook, отпраinляемые fileы можно inременно withхранять in папtoу inеб-withерinера. У IIS this папtoа wwwroot
|
||||
|
||||
:::
|
||||
|
||||
У Viber еwithть дinа REST API: одandн for work with toаtoламand, а inторой - for чат-ботоin. In обоandх withлучаях mainоinнымand optionетрамand withлужат **Token** and **UserID**
|
||||
|
||||
- If inам необходandмо упраinлять toаtoлом:
|
||||
1. Зайдandте in прandложенandе Viber and withздайте ноinый toаtoл
|
||||
- If you need to manage a channel:
|
||||
1. Open the Viber app and create a new channel
|
||||
|
||||
|
||||
|
||||
2. Towithле withзданandя, перейдandте in towithтройtoand toаtoла -> "For разработчandtoоin", and withtoопandруйте **Token**
|
||||
2. After creation, go to the channel settings -> For developers, and copy the **Token**
|
||||
|
||||
|
||||
|
||||
3. Уwithтаноinandте Webhook. See. Set Webhook
|
||||
4. **UserID** - inаш ID (адмandнandwithтратора toаtoла). See. Get channel information
|
||||
3. Set webhook (see Set webhook)
|
||||
4. **UserID** - your ID (channel administrator). See Get Channel Information for details
|
||||
|
||||
<br/>
|
||||
|
||||
- If inам необходandм чат-бот:
|
||||
1. Go по withwithылtoе [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) and аinторfromуйтеwithь with inашandм номером телефоto, toоторый прandinязан to Viber
|
||||
- If you need a chatbot:
|
||||
1. Go to the link [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) and authorize yourself with your phone number linked to Viber
|
||||
|
||||
|
||||
|
||||
2. Inыберandте пунtoт withзданandя ноinого бота
|
||||
2. Select the option to create a new bot
|
||||
|
||||
|
||||
|
||||
3. In меню withзданandя бота заполнandте inwithе необходandмые fields
|
||||
3. In the bot creation menu, fill in all the required fields
|
||||
|
||||
|
||||
|
||||
4. Сtoопandруйте **Token**
|
||||
4. Copy the **Token**
|
||||
|
||||
|
||||
|
||||
4. Nайтand withinоего ноinого бота inы можете отwithtoанandроinаin QR to withтранandце withзданandя or in towithтройtoах (пунtoт чат-боты) in прandложенandand Viber.
|
||||
4. To find your new bot, you can scan the QR code on the creation page or in the settings (chat bots section) within the Viber app.
|
||||
|
||||
|
||||
|
||||
5. Сейчаwith inы не можете toчать дandалог with ботом, withof start необходandмо уwithтаноinandть Webhook. See. Set Webhook
|
||||
6. Towithле start **UserID** will ID toонtoретного челоinеtoа, inедущего дandалог with ботом. Get можно from обworktoand incoming withобщенandя по Webhook
|
||||
5. You cannot start a conversation with the bot right now. First, you need to set up a webhook. See Set Webhook
|
||||
6. After launch, the **User ID** will be the ID of the specific person engaging with the bot. You can obtain it from processing incoming messages via Webhook
|
||||
|
||||
|
||||
**Inажно:** ID одного and того же пользоinателя у чата and toаtoла - this разные зtoченandя. Notльзя andwithпользоinать ID, полученный from withобщенandя боту for inызоinа methodоin упраinленandя toаtoлом and toоборот.
|
||||
**Important**: The ID of the same user in chat and channel is different. You cannot use the ID obtained from a message to the bot to invoke channel management methods and vice versa
|
||||
|
||||
@ -33,7 +33,7 @@ sidebar_class_name: VK
|
||||
|
||||
**1. v**
|
||||
|
||||
Параметр v означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить
|
||||
Параметр `v` означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить
|
||||
|
||||
**2. from_group**
|
||||
|
||||
|
||||
@ -52,4 +52,4 @@ sidebar_class_name: Viber
|
||||
6. После запуска **IDПользователя** будет ID конкретного человека, ведущего диалог с ботом. Получить можно из обработыки входящих сообщения по Webhook
|
||||
|
||||
|
||||
**Важно:** ID одного и того же пользователя у чата и канала - это разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот.
|
||||
**Важно:** ID одного и того же пользователя у чата и канала - это разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот
|
||||
@ -3699,6 +3699,39 @@
|
||||
"После создания, перейдите в настройки канала -> Для разработчиков, и скопируйте **Токен**":"After creation, go to the channel settings -> For developers, and copy the **Token**",
|
||||
"Установите Webhook. См. Установить Webhook":"Set webhook (see Set webhook)",
|
||||
"**IDПользователя** - ваш ID (администратора канала). См. Получить информацию о канале":"**UserID** - your ID (channel administrator). See Get Channel Information for details",
|
||||
"Если вам необходим чат-бот":"If you need a chatbot"
|
||||
"Если вам необходим чат-бот":"If you need a chatbot",
|
||||
"Перейдите по ссылке":"Go to the link",
|
||||
"и авторизуйтесь с вашим номером телефона, который привязан к Viber":"and authorize yourself with your phone number linked to Viber",
|
||||
"Выберите пункт создания нового бота":"Select the option to create a new bot",
|
||||
"В меню создания бота заполните все необходимые поля":"In the bot creation menu, fill in all the required fields",
|
||||
"Скопируйте **Токен**":"Copy the **Token**",
|
||||
"Найти своего нового бота вы можете отсканировав QR на странице создания или в настройках (пункт чат-боты) в приложении Viber":"To find your new bot, you can scan the QR code on the creation page or in the settings (chat bots section) within the Viber app",
|
||||
"Сейчас вы не можете начать диалог с ботом, сначала необходимо установить Webhook. См. Установить Webhook":"You cannot start a conversation with the bot right now. First, you need to set up a webhook. See Set Webhook",
|
||||
"После запуска **IDПользователя** будет ID конкретного человека, ведущего диалог с ботом. Получить можно из обработыки входящих сообщения по Webhook":"After launch, the **User ID** will be the ID of the specific person engaging with the bot. You can obtain it from processing incoming messages via Webhook",
|
||||
"**Важно:** ID одного и того же пользователя у чата и канала - это разные значения. Нельзя использовать ID, полученный из сообщения боту для вызова методов управления каналом и наоборот":"**Important**: The ID of the same user in chat and channel is different. You cannot use the ID obtained from a message to the bot to invoke channel management methods and vice versa",
|
||||
"Она заточена для работы с сообществами и выполнением действий от их имени":"It is geared towards working with communities and performing actions on their behalf",
|
||||
"Для начала работы необходимо получить некоторые параметры для VK API":"To begin, you need to obtain certain parameters for the VK API",
|
||||
"Перечень необходимых данных в виде структуры содержится в функции *ПолучитьСтандартныеПараметры()*. Вы можете указывать значения параметров прямо в ней или же передавать их структурой при вызове любых других методов библиотеки в качестве необязательного параметра *Параметры* (последний во всех методах билиотеки). В последнем случае стандартные параметры будут перезаписаны по ключам теми, которые переданы при вызове метода. Перезаписаны будут только совпадающие по ключам данные. Если какой то параметр есть в наборе стандартных, но не был передан при вызове метода, то он сохранит стандартное значение":"The list of necessary data in the form of a structure is contained in the function *GetStandardParameters()*. You can specify parameter values directly within it or pass them as a structure when calling any other library methods as an optional parameter *Parameters* (the last one in all library methods). In the latter case, the standard parameters will be overwritten by the ones passed during the method call. Only the data with matching keys will be overwritten. If a parameter exists in the standard set but was not passed during the method call, it will retain its default value",
|
||||
"Рассмотрим получение каждого значения":"Let's consider obtaining of each value",
|
||||
"Параметр `v` означает версию VK API. Тестирование проводилось на 5.131, рекомендуется его таким и оставить":"The parameter `v` denotes the version of the VK API. Testing was conducted on version 5.131, and it is recommended to keep it as such",
|
||||
"От лица группы. Должен быть 1":"On behalf of the group. It should be set to 1",
|
||||
"ID группы. Если у вас стандартный адрес группы, то id можно найти в URL. В противном случае он будет на вкладке \"Управление\" в группе, под полем Адрес. owner_id - тоже самое, но со знаком '-' впереди":"Group ID. If you have a standard group URL, you can find the ID in the URL. Otherwise, it will be on the 'Manage' tab in the group, below the Address field. 'owner_id' is the same but with a '-' sign in front of it",
|
||||
"app_id - ID приложения. Для создания приложения необходимо":"app_id - Application ID. To create an application, you need to",
|
||||
"Перейти по адресу":"Go to the",
|
||||
"авторизоваться и ввести свои данные физ. или юр. лица":"authorize and enter your personal or company information",
|
||||
"Ввести название приложения и выбрать пункт":"Enter the application name and select the ",
|
||||
"Ввести домееное имя и URL обработчика перенаправлений. Тут нужно отметить, что данный механизм создания приложений - новый. Еще недавно приложения VK создавались иначе и иметь redirect_url для них было не нужно. На данный момент не совсем понятно, зачем он нужен нам для серверного приложения - просто такого понятия как серверное приложение у VK теперь нет. Теоретически, туда можно вписать что угодно - для работы с библиотекой в получении обратных данных нет необходимости. Однако, с течением времени, это может измениться":"Enter the domain name and the URL of the redirect handler. It's worth noting that this mechanism for creating VK applications is new. Until recently, VK applications were created differently, and having a redirect URL was unnecessary. At the moment, it's not entirely clear why it's needed for our server application - VK no longer distinguishes server applications as such. Theoretically, you can enter anything there - there is no need for receiving callback data to work with the library. However, this may change over time",
|
||||
"Ввести паспортные данные или данные об организации, включить доступ к сообществам (короче, если у вас уже было приложение до этого, то вам крупно повезло, а если нет российского паспорта - придется писать в поддержку)":"Enter passport details or organization information, enable access to communities (in short, if you already had an application before, you're lucky, but if you don't have a Russian passport, you'll have to contact support)",
|
||||
"Получить app_id на странице приложения":"Get app_id at the application page",
|
||||
"Ссылку на получение acess_token можно получить при помощи функции *СоздатьСсылкуПолученияТокена* или склеить вручную:":"You can obtain a link for acquiring the access token using the function *CreateTokenRetrievalLink* or manually concatenate it",
|
||||
"По этой ссылке необходимо перейти в браузере":"You need to follow this link in your browser",
|
||||
"Авторизоваться через ВК и подтвердить доступ":"Authorize through VK and confirm access",
|
||||
"Забрать токен из параметра URL в адресной строке":"Retrieve the token from the URL parameter in the address bar",
|
||||
"Некоторые методы, например для работы с чат-ботом сообщества, принимают в качестве параметра communitytoken - в этих методах он заменяет access_token. Для его получения необходимо":"Some methods, such as those for working with community chat bots, accept the parameter 'communitytoken' instead of 'access_token'. To obtain it, you need to",
|
||||
"Зайти в раздел \"Управление\" в группе ВК":"Go to the 'Manage' section in the VK group",
|
||||
"Найти вкладку \"Работа с API\"":"Find the 'API usage' tab",
|
||||
"Нажать \"Создать ключ\" и забрать его":"Click on 'Create key' and retrieve it",
|
||||
"Пока вам не нужно использовать такие методы, получать communitytoken не обязательно":"You don't need to obtain the 'communitytoken' if you're not using such methods at the moment",
|
||||
"Дополнительно":"Additionally"
|
||||
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user