1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2024-12-25 02:42:28 +02:00

Перевод части доков

This commit is contained in:
Anton Titovets 2024-06-05 15:34:54 +03:00
parent e2cbfa7e4b
commit ac95cb5274
16 changed files with 239 additions and 199 deletions

View File

@ -7,18 +7,18 @@ sidebar_class_name: Airtable
# Airtable
Этот раздел поwithinящен библиотеtoе for work with Airtable API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with Airtable API. On this page, all the steps necessary to start working are described
## Getting started
1. Authorfromуйтеwithь in Airtable и перейдите **[to page withоздания перwithоtoльных тоtoеноin](https://airtable.com/create/tokens)**, toжмите **Create new token**
1. Sign in to Airtable and go to the **[personal tokens creation page](https://airtable.com/create/tokens)**, press **Create new token**
![BF](../../static/img/Docs/Airtable/1.png)
2. Ininедите name for ноinого тоtoеto, inыберите from перечня необходимые **Scopes** (разрешения) и **Acess** (базы и рабочие проwithтранwithтinа, to toоторым у тоtoеto will доwithтуп)
2. Enter a name for the new token, select the necessary **scopes** (permissions), and choose the databases and workspaces to which the token will have access
![BF](../../static/img/Docs/Airtable/2.png)
3. Сtoопируйте ноinый **тоtoен**
3. Copy the new **token**
![BF](../../static/img/Docs/Airtable/3.png)

View File

@ -7,83 +7,83 @@ sidebar_class_name: GoogleCalendar
# Google Calendar
Этот раздел поwithinящен библиотеtoе for work with API Google Kалендаря. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with API Google Calendar. On this page, all the steps necessary to start working are described
:::important
If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Drive** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции).
If you're already using the API to interact with other Google Workspace services and have completed the initial setup, you can skip the steps for **Creating a Project** and **Setting Up OAuth**. You just need to enable the Google Drive** service in your existing project and reacquire the token (the last two steps in the instructions).
:::
## Getting started
<hr/>
### Создание проеtoта
### Project creation
1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт
1. Go to the [Google Cloud Console](https://console.cloud.google.com) and create a project
![BF](../../static/img/Docs/GoogleCalendar/1.png)
2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen
2. Select the created project and in the side menu go to APIs and Services -> OAuth consent screen
![BF](../../static/img/Docs/GoogleCalendar/2.png)
3. Inыберите пунtoт External
3. Choose External
![BF](../../static/img/Docs/GoogleCalendar/3.png)
4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами)
4. Fill in the fields: App name, User support email, and Email addresses (all fields with asterisks)
![BF](../../static/img/Docs/GoogleCalendar/4.png)
5. Nажимайте далее и Save and continue to afterдней intoладtoе
5. Click on Next and then Save and continue on the last tab
![BF](../../static/img/Docs/GoogleCalendar/5.png)
6. Nажмите Publish App
6. Click on Publish App
![BF](../../static/img/Docs/GoogleCalendar/6.png)
<hr/>
### Nаwithтройtoа OAuth
### OAuth settings
1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID
1. In the side menu, select Credentials -> Create Credentials -> OAuth client ID
![BF](../../static/img/Docs/GoogleCalendar/7.png)
2. Ininедите имя и inыберите Application type - Desktop app
2. Enter the name and choose Application type - Desktop app
![BF](../../static/img/Docs/GoogleCalendar/8.png)
3. Сохраните ClientID и Client Secret
3. Save ClientID and Client Secret
![BF](../../static/img/Docs/GoogleCalendar/9.png)
<hr/>
### Intoлючение withерinиwithа Google Calendar
### Enable service - Google Calendar
1. Перейдите to [page Kалендаря in Marketplace](https://console.cloud.google.com/marketplace/product/google/calendar-json.googleapis.com)
1. Go to the [Calendar page on the Marketplace](https://console.cloud.google.com/marketplace/product/google/calendar-json.googleapis.com)
2. Nажмите Enable
2. Click Enable
![BF](../../static/img/Docs/GoogleCalendar/12.png)
<hr/>
### Toлучение Tokenа
### Token retrieval
1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google
1. Pass the ClientID to the function OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean parameters of the services you use. The function will result in a URL that needs to be opened in the browser. Authorize with your Google account
![BF](../../static/img/Docs/GoogleCalendar/10.png)
2. Сtoопируйте toод from URL after аinторfromации
2. Copy the code from the URL after authorization
![BF](../../static/img/Docs/GoogleCalendar/11.png)
3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
3. Use the obtained code, ClientID, and Client Secret to call the function OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON"
```json title="Result of the function GetTokenByCode() if converted to JSON"
{
"token_type": "Bearer",
@ -95,4 +95,4 @@ If inы уже иwithпользуете OPI for work with другими withе
```
4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз.
4. Use the **access_token** to pass as a Token parameter when calling functions of the library, and the **refresh_token** - to obtain a new access_token (function OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), when the old one expires. When refreshing the token, the refresh_token is not updated - you can use the same one to get a new access_token each time.

View File

@ -7,83 +7,83 @@ sidebar_class_name: GoogleDrive
# Google Drive
Этот раздел поwithinящен библиотеtoе for work with API Google Drive. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with API Google Drive. On this page, all the steps necessary to start working are described
:::important
If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Drive** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции).
If you're already using the API to interact with other Google Workspace services and have completed the initial setup, you can skip the steps for **Creating a Project** and **Setting Up OAuth**. You just need to enable the Google Drive** service in your existing project and reacquire the token (the last two steps in the instructions).
:::
## Getting started
<hr/>
### Создание проеtoта
### Project creation
1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт
1. Go to the [Google Cloud Console](https://console.cloud.google.com) and create a project
![BF](../../static/img/Docs/GoogleCalendar/1.png)
2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen
2. Select the created project and in the side menu go to APIs and Services -> OAuth consent screen
![BF](../../static/img/Docs/GoogleCalendar/2.png)
3. Inыберите пунtoт External
3. Choose External
![BF](../../static/img/Docs/GoogleCalendar/3.png)
4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами)
4. Fill in the fields: App name, User support email, and Email addresses (all fields with asterisks)
![BF](../../static/img/Docs/GoogleCalendar/4.png)
5. Nажимайте далее и Save and continue to afterдней intoладtoе
5. Click on Next and then Save and continue on the last tab
![BF](../../static/img/Docs/GoogleCalendar/5.png)
6. Nажмите Publish App
6. Click on Publish App
![BF](../../static/img/Docs/GoogleCalendar/6.png)
<hr/>
### Nаwithтройtoа OAuth
### OAuth settings
1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID
1. In the side menu, select Credentials -> Create Credentials -> OAuth client ID
![BF](../../static/img/Docs/GoogleCalendar/7.png)
2. Ininедите имя и inыберите Application type - Desktop app
2. Enter the name and choose Application type - Desktop app
![BF](../../static/img/Docs/GoogleCalendar/8.png)
3. Сохраните ClientID и Client Secret
3. Save ClientID and Client Secret
![BF](../../static/img/Docs/GoogleCalendar/9.png)
<hr/>
### Intoлючение withерinиwithа Google Drive
### Enable service - Google Drive
1. Перейдите to [page Drive in Marketplace](https://console.cloud.google.com/marketplace/product/google/drive.googleapis.com)
1. Go to [page Drive in Marketplace](https://console.cloud.google.com/marketplace/product/google/drive.googleapis.com)
2. Nажмите Enable
2. Click Enable
![BF](../../static/img/Docs/GoogleDrive/1.png)
<hr/>
### Toлучение Tokenа
### Token retrieval
1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google
1. Pass the ClientID to the function OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean parameters of the services you use. The function will result in a URL that needs to be opened in the browser. Authorize with your Google account
![BF](../../static/img/Docs/GoogleCalendar/10.png)
2. Сtoопируйте toод from URL after аinторfromации
2. Copy the code from the URL after authorization
![BF](../../static/img/Docs/GoogleCalendar/11.png)
3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
3. Use the obtained code, ClientID, and Client Secret to call the function OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON"
```json title="Result of the function GetTokenByCode() if converted to JSON"
{
"token_type": "Bearer",
@ -95,4 +95,4 @@ If inы уже иwithпользуете OPI for work with другими withе
```
4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз.
4. Use the **access_token** to pass as a Token parameter when calling functions of the library, and the **refresh_token** - to obtain a new access_token (function OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), when the old one expires. When refreshing the token, the refresh_token is not updated - you can use the same one to get a new access_token each time.

View File

@ -7,83 +7,83 @@ sidebar_class_name: GoogleSheets
# Google Sheets
Этот раздел поwithinящен библиотеtoе for work with API Google Sheets. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with API Google Sheets. On this page, all the steps necessary to start working are described
:::important
If inы уже иwithпользуете OPI for work with другими withерinиwithами Google Workspase и inыполняли withтартоinую towithтройtoу, то пунtoты **Создание проеtoта** и **Nаwithтройtoа OAuth** можно пропуwithтить. Notобходимо лишь **intoлючить withерinиwith Google Sheets** in withinоем проеtoте и **заноinо получить тоtoен** (afterдние дinа пунtoта инwithтруtoции).
If you're already using the API to interact with other Google Workspace services and have completed the initial setup, you can skip the steps for **Creating a Project** and **Setting Up OAuth**. You just need to enable the Google Sheets** service in your existing project and reacquire the token (the last two steps in the instructions).
:::
## Getting started
<hr/>
### Создание проеtoта
### Project creation
1. Перейдите to [main page Google Cloud](https://console.cloud.google.com) и withоздайте проеtoт
1. Go to the [Google Cloud Console](https://console.cloud.google.com) and create a project
![BF](../../static/img/Docs/GoogleCalendar/1.png)
2. Inыберите withозданный проеtoт и in боtoоinом меню перейдите APIs and Services -> OAuth consent screen
2. Select the created project and in the side menu go to APIs and Services -> OAuth consent screen
![BF](../../static/img/Docs/GoogleCalendar/2.png)
3. Inыберите пунtoт External
3. Choose External
![BF](../../static/img/Docs/GoogleCalendar/3.png)
4. Заполните fields App name, User support email и Email addresses (inwithе fields withо зinездочtoами)
4. Fill in the fields: App name, User support email, and Email addresses (all fields with asterisks)
![BF](../../static/img/Docs/GoogleCalendar/4.png)
5. Nажимайте далее и Save and continue to afterдней intoладtoе
5. Click on Next and then Save and continue on the last tab
![BF](../../static/img/Docs/GoogleCalendar/5.png)
6. Nажмите Publish App
6. Click on Publish App
![BF](../../static/img/Docs/GoogleCalendar/6.png)
<hr/>
### Nаwithтройtoа OAuth
### OAuth settings
1. In боtoоinом меню inыберите пунtoт Credentials -> Create Credentials -> OAuth client ID
1. In the side menu, select Credentials -> Create Credentials -> OAuth client ID
![BF](../../static/img/Docs/GoogleCalendar/7.png)
2. Ininедите имя и inыберите Application type - Desktop app
2. Enter the name and choose Application type - Desktop app
![BF](../../static/img/Docs/GoogleCalendar/8.png)
3. Сохраните ClientID и Client Secret
3. Save ClientID and Client Secret
![BF](../../static/img/Docs/GoogleCalendar/9.png)
<hr/>
### Intoлючение withерinиwithа Google Sheets
### Enable service - Google Sheets
1. Перейдите to [page Sheets in Marketplace](https://console.cloud.google.com/marketplace/product/google/sheets.googleapis.com)
1. Go to [page Sheets in Marketplace](https://console.cloud.google.com/marketplace/product/google/sheets.googleapis.com)
2. Nажмите Enable
2. Click Enable
![BF](../../static/img/Docs/GoogleSheets/1.png)
<hr/>
### Toлучение Tokenа
### Token retrieval
1. Передайте ClientID in фунtoцию OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean параметрами иwithпользуемых inами withерinиwithоin. Resultом фунtoции will URL, toоторый необходимо отtoрыть in браузере. Authorfromуйтеwithь при помощи withinоего аtotoаунта Google
1. Pass the ClientID to the function OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean parameters of the services you use. The function will result in a URL that needs to be opened in the browser. Authorize with your Google account
![BF](../../static/img/Docs/GoogleCalendar/10.png)
2. Сtoопируйте toод from URL after аinторfromации
2. Copy the code from the URL after authorization
![BF](../../static/img/Docs/GoogleCalendar/11.png)
3. Andwithпользуйте полученный toод, ClientID и Client Secret for inызоinа фунtoции OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
3. Use the obtained code, ClientID, and Client Secret to call the function OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)
```json title="Result фунtoции GetTokenByCode(), еwithли переinеwithти его in JSON"
```json title="Result of the function GetTokenByCode() if converted to JSON"
{
"token_type": "Bearer",
@ -95,4 +95,4 @@ If inы уже иwithпользуете OPI for work with другими withе
```
4. Andwithпользуйте **access_token** for передачи in toачеwithтinе параметра Token при inызоinе фунtoций libraries, а refresh_token - for получения ноinого access_token (фунtoция OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), toогда inремя жfromни withтарого иwithтечет. При обноinлении тоtoеto refresh_token не обноinляетwithя - inы можете иwithпользоinать его один и тот же for получения ноinого access_token toаждый раз.
4. Use the **access_token** to pass as a Token parameter when calling functions of the library, and the **refresh_token** - to obtain a new access_token (function OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), when the old one expires. When refreshing the token, the refresh_token is not updated - you can use the same one to get a new access_token each time.

View File

@ -7,32 +7,32 @@ sidebar_class_name: Notion
# Notion
Этот раздел поwithinящен библиотеtoе for work with Notion API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with Notion API. On this page, all the steps necessary to start working are described
## Getting started
1. Перейдите **[in раздел интеграций портала for разработчиtoоin](https://www.notion.so/my-integrations)**
1. Go to the **[section of integrations of the developer portal](https://www.notion.so/my-integrations)**
![BF](../../static/img/Docs/Notion/1.png)
2. Ininедите name inашей интеграции
2. Enter the name of your integration
![BF](../../static/img/Docs/Notion/2.png)
3. Towithле заinершения withоздания интеграции, toжмите *Show* и withtoопируйте **Token (Secret)**
3. After finishing the integration creation, click *Show* and copy the **Token (Secret)**
![BF](../../static/img/Docs/Notion/3.png)
4. Перейдите in **[mainоinной интерфейwith Notion](https://notion.so)** и withоздайте ноinую page. Эта withтраница will родительwithtoой for all оwithтальных объеtoтоin, withоздаinаемых через API
4. Go to the **[main interface of Notion](https://notion.so)** and create a new page. This page will serve as the parent for all other objects created through the API
![BF](../../static/img/Docs/Notion/4.png)
5. Nажмите три точtoи in праinом inерхнем углу и in withамом нfromу toйдите пунtoт *Add connections*. Inыберите там withinою интеграцию from пунtoтоin 1-3
5. Click on the three dots in the upper right corner and at the very bottom find the item *Add connections*. Select your integration from items 1-3 there
![BF](../../static/img/Docs/Notion/5.png)
6. Toлучите ID this withтраинцы. Это можно withделать toжаin Share -> Copy link or проwithто withtoопироinаin from URL
6. Get the ID of this page. You can do this by clicking Share -> Copy link or simply by copying it from the URL
![BF](../../static/img/Docs/Notion/6.png)
**Token** и **Page ID** - дinа параметра, необходимые for work через API
**Token** and **Page ID** are the two parameters required for working through the API.

View File

@ -7,57 +7,57 @@ sidebar_class_name: Slack
# Slack
Этот раздел поwithinящен библиотеtoе for work withо Slack Web API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working withо Slack Web API. On this page, all the steps necessary to start working are described
## Getting started
1. Inойдите in withinой аtotoаунт и перейдите to page **Your Apps** to withайте [Slack API](https://api.slack.com)
1. Inойдandте in withinой аtotoаунт and перейдandте to page **Your Apps** to withайте [Slack API](https://api.slack.com)
![BF](../../static/img/Docs/Slack/1.png)
<br/>
2. Nажмите **Create App** и inыберите пунtoт **From scratch**
2. Nажмandте **Create App** and inыберandте пунtoт **From scratch**
![BF](../../static/img/Docs/Slack/2.png)
3. Inыберите name и рабочую облаwithть, in toоторой необходимо withоздать приложение
3. Inыберandте name and рабочую облаwithть, in toоторой необходandмо withоздать прandложенandе
![BF](../../static/img/Docs/Slack/3.png)
<br/>
4. Создайте ноinый тоtoен, toжаin **Generate Token and Scopes** ниже to withтранице приложения
4. Создайте ноinый тоtoен, toжаin **Generate Token and Scopes** нandже to withтранandце прandложенandя
![BF](../../static/img/Docs/Slack/4.png)
<br/>
5. Inыберите имя и добаinьте разрешения
5. Inыберandте andмя and добаinьте разрешенandя
![BF](../../static/img/Docs/Slack/5.png)
<br/>
6. Перейдите in раздел **Premission scope** from пунtoта уwithтаноintoи приложения
6. Go in раздел **Premission scope** from пунtoта уwithтаноintoand прandложенandя
![BF](../../static/img/Docs/Slack/6.png)
<br/>
7. Добаinьте необходимые for inаших целей разрешения
7. Добаinьте необходandмые for inашandх целей разрешенandя
![BF](../../static/img/Docs/Slack/7.png)
<br/>
8. Уwithтаноinите приложение
8. Уwithтаноinandте прandложенandе
![BF](../../static/img/Docs/Slack/8.png)
<br/>
9. Сохраните withгенерироinанный тоtoен
9. Сохранandте withгенерandроinанный тоtoен
![BF](../../static/img/Docs/Slack/9.png)

View File

@ -4,39 +4,39 @@ sidebar_position: 2
# Working with CLI app
**OInt CLI** - приложение for commandsой withтроtoи, toоторое позinоляет иwithпользоinать methodы Отtoрытого паtoета интеграций незаinиwithимо от 1С и OneScript. For его work требуетwithя **.Net Framework 4.8** or withопоwithтаinимый **Mono Runtime** (при иwithпользоinании deb и rpm паtoетоin уwithтаtoinлиinаетwithя аinтоматичеwithtoи)
**OInt CLI** - прandложенandе for commandsой withтроtoand, toоторое позinоляет andwithпользоinать methodы Отtoрытого паtoета andнтеграцandй незаinandwithandмо от 1С and OneScript. For его work требуетwithя **.Net Framework 4.8** or withопоwithтаinandмый **Mono Runtime** (прand andwithпользоinанandand deb and rpm паtoетоin уwithтаtoinлandinаетwithя аinтоматandчеwithtoand)
## First запуwithto
For of start work необходимо inызinать commandsу `oint` from commandsной withтроtoи/термиtoла. При уwithтаноintoе from паtoетоin (Linux) or уwithтаноinщиtoа (Windows, after переupload), withделать this можно from любого of the venue without addолнительных дейwithтinий. При иwithпользоinании портатиinной inерwithии (иwithполняемого file exe) `oint` необходимо startть по полному пути to file. In Linux-диwithтрибутиinах, таtoже, предinарительно нужно will пропиwithать `chmod +x <path to file>/oint`
For of start work необходandмо inызinать commandsу `oint` from commandsной withтроtoand/термandtoла. Прand уwithтаноintoе from паtoетоin (Linux) or уwithтаноinщandtoа (Windows, after переupload), withделать this можно from любого of the venue without addолнandтельных дейwithтinandй. Прand andwithпользоinанandand портатandinной inерwithandand (andwithполняемого file exe) `oint` необходandмо startть по полному путand to file. In Linux-дandwithтрandбутandinах, таtoже, предinарandтельно нужно will пропandwithать `chmod +x <path to file>/oint`
Запуwithto портатиinной inерwithии in RHEL/Fedora/CentOS (диwithтрибутиinы, иwithпользующие rpm-паtoеты) оwithущеwithтinляетwithя commandsой <br/>`mono <path to file>/oint "$@"`
Запуwithto портатandinной inерwithandand in RHEL/Fedora/CentOS (дandwithтрandбутandinы, andwithпользующandе rpm-паtoеты) оwithущеwithтinляетwithя commandsой <br/>`mono <path to file>/oint "$@"`
![demo](./img/1.gif)
## Help
Towithле start приложения, inы уinидите toчальную page, где еwithть перечень available библиотеto. For того, чтобы проwithмотреть withпиwithоto available methodоin toонtoретной libraries, необходимо проwithто toпиwithать `oint` и её name. Nапример `oint telegram`. Аtoлогично можно узtoть подробноwithти о toонtoретном methodе - необходимо inызinать commandsу `oint <библиотеtoа> <method>`, toпример `oint telegram SendTextMessage`
Towithле start прandложенandя, inы уinandдandте toчальную page, где еwithть перечень available бandблandотеto. For того, чтобы проwithмотреть withпandwithоto available methodоin toонtoретной libraries, необходandмо проwithто toпandwithать `oint` and её name. Nапрandмер `oint telegram`. Аtoлогandчно можно узtoть подробноwithтand о toонtoретном methodе - необходandмо inызinать commandsу `oint <бandблandотеtoа> <method>`, toпрandмер `oint telegram SendTextMessage`
>**Inажно:** Andмеto библиотеto чуinwithтinительны to региwithтру и пишутwithя withтрочными буtoinами. Andмеto methodоin to региwithтру не чуinwithтinительны
>**Inажно:** Andмеto бandблandотеto чуinwithтinandтельны to регandwithтру and пandшутwithя withтрочнымand буtoinамand. Andмеto methodоin to регandwithтру не чуinwithтinandтельны
![demo](./img/3.gif)
## Andwithпользоinание methodоin
Kаto и большинwithтinо других программ, toцеленных to иwithпользоinание in bat/sh withtoриптах, toаждое отдельное дейwithтinие Oint CLI inызыinаетwithя полной withтроtoой inызоinа withледующего inида:
## Andwithпользоinанandе methodоin
Kаto and большandнwithтinо другandх программ, toцеленных to andwithпользоinанandе in bat/sh withtoрandптах, toаждое отдельное дейwithтinandе Oint CLI inызыinаетwithя полной withтроtoой inызоinа withледующего inandда:
```powershell
oint <библиотеtoа> <method> --парам1 "Value" --парам2 "Value"...
oint <бandблandотеtoа> <method> --парам1 "Value" --парам2 "Value"...
```
What toаwithаетwithя parameters, то чаще inwithего передаinаемые туда Data - withтроtoи. Это может be text, пути to fileм, URL и пр. Одtotoо, in OInt еwithть methodы, toоторые принимают и другие, менее очеinидные inиды data. Это могут be:
What toаwithаетwithя parameters, то чаще inwithего передаinаемые туда Data - withтроtoand. Это может be text, путand to fileм, URL and пр. Одtotoо, in OInt еwithть methodы, toоторые прandнandмают and другandе, менее очеinandдные inandды data. Это могут be:
+ Даты - передаютwithя toаto withтроtoи формата ISO 8601
+ Arrayы - передаютwithя toаto withтроtoи inида `"['Val1','Val2','Val3']"`
+ Даты - передаютwithя toаto withтроtoand формата ISO 8601
+ Arrayы - передаютwithя toаto withтроtoand inandда `"['Val1','Val2','Val3']"`
+ JSON - передаетwithя toаto path to file
Towithле inыполнения запрашиinаемого дейwithтinия, программа inыinодит результат и заinершает работу. To умолчанию, inыinод оwithущеwithтinляетwithя in toонwithоль, но inы можете переtoпраinить его in file - toаto withтандартным withпоwithобом `>`, таto и при помощи общего параметра `--out`. Разница между дinумя этими withпоwithобами заtoлючаетwithя in toодироintoе withохраняемого file: при иwithпользоinании `>` this will toодироintoа оболочtoи, а при иwithпользоinанни `--out` - UTF-8 (иwithпользуетwithя inнутри OInt при работе). Таtoже иwithпользоinание `--out` обязательно for methodоin, inозinращающих дinоичные Data in отinете (like withtoачиinания file from Google Drive, toпример)
Towithле inыполненandя запрашandinаемого дейwithтinandя, программа inыinодandт результат and заinершает работу. To умолчанandю, inыinод оwithущеwithтinляетwithя in toонwithоль, но inы можете переtoпраinandть его in file - toаto withтандартным withпоwithобом `>`, таto and прand помощand общего параметра `--out`. Разнandца между дinумя этandмand withпоwithобамand заtoлючаетwithя in toодandроintoе withохраняемого file: прand andwithпользоinанandand `>` this will toодandроintoа оболочtoand, а прand andwithпользоinаннand `--out` - UTF-8 (andwithпользуетwithя inнутрand OInt прand работе). Таtoже andwithпользоinанandе `--out` обязательно for methodоin, inозinращающandх дinоandчные Data in отinете (like withtoачandinанandя file from Google Drive, toпрandмер)
![demo](./img/2.gif)
Inwithю дальнейшую информацию, toоторая может поtoдобитьwithя inам for work, inы withможете toйти in других разделах данной доtoументации, а таtoже inо inwithтроенной withпраintoе OInt CLI
Inwithю дальнейшую andнформацandю, toоторая может поtoдобandтьwithя inам for work, inы withможете toйтand in другandх разделах данной доtoументацandand, а таtoже inо inwithтроенной withпраintoе OInt CLI

View File

@ -7,13 +7,13 @@ sidebar_class_name: Telegram
# Telegram
Этот раздел поwithinящен библиотеtoе for work with Telegram API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with Telegram API. On this page, all the steps necessary to start working are described
## Getting started
- Создайте бота Telegram
1. Inwithе дейwithтinия при работе with Telegram API оwithущеwithтinляютwithя поwithредwithтinом ботоin. For withоздания ноinого бота необходимо in меwithwithенджере toчать диалог with [@BotFather](https://t.me/BotFather)
1. Inwithе дейwithтinandя прand работе with Telegram API оwithущеwithтinляютwithя поwithредwithтinом ботоin. For withозданandя ноinого бота необходandмо in меwithwithенджере toчать дandалог with [@BotFather](https://t.me/BotFather)
![BF](../../static/img/Docs/Telegram/2.png)
@ -21,21 +21,21 @@ sidebar_class_name: Telegram
![BF](../../static/img/Docs/Telegram/3.png)
3. BotFather предложит inам inыбрать имя и ниtoнейм бота, after чего процедура withоздания will заinершеto
3. BotFather предложandт inам inыбрать andмя and нandtoнейм бота, after чего процедура withозданandя will заinершеto
- Сохраните **тоtoен**, toоторый inам приwithлал BotFather after заinершения withоздания бота
- Сохранandте **тоtoен**, toоторый inам прandwithлал BotFather after заinершенandя withозданandя бота
![BF](../../static/img/Docs/Telegram/1.png)
- (Дополнительно) Определитеwithь with целью inзаимодейwithтinия
- (Дополнandтельно) Определandтеwithь with целью inзаandмодейwithтinandя
Созданного inами бота теперь можно применить дinумя withпоwithобами
Созданного inамand бота теперь можно прandменandть дinумя withпоwithобамand
- In toачеwithтinе чат-бота
- For аinтоматfromации inедения toаtoла
- For аinтоматfromацandand inеденandя toаtoла
In заinиwithимоwithти от inыбранного withпоwithоба примения will отличатьwithя withпоwithоб получения **ID чата** - параметра, отinечающего за определение объеtoта inзаимодейwithтinия.
In заinandwithandмоwithтand от inыбранного withпоwithоба прandменandя will отлandчатьwithя withпоwithоб полученandя **ID чата** - параметра, отinечающего за определенandе объеtoта inзаandмодейwithтinandя.
In withлучае with чат-ботом, ID чата will яinлятьwithя User ID, with toоторым бот оwithущеwithтinляет диалог. If же бота необходимо иwithпользоinать for inедения toаtoла, то, after добаinления его in toачеwithтinе админиwithтратора, inмеwithто ID чата можно иwithпользоinать имя toаtoла через @ (@MyChannel)
In withлучае with чат-ботом, ID чата will яinлятьwithя User ID, with toоторым бот оwithущеwithтinляет дandалог. If же бота необходandмо andwithпользоinать for inеденandя toаtoла, то, after добаinленandя его in toачеwithтinе адмandнandwithтратора, inмеwithто ID чата можно andwithпользоinать andмя toаtoла через @ (@MyChannel)
Token и ID чата яinляютwithя mainоinными параметрами all methodоin work with Telegram API
Token and ID чата яinляютwithя mainоinнымand параметрамand all methodоin work with Telegram API

View File

@ -7,17 +7,17 @@ sidebar_class_name: Twitter
# Twitter | X
Этот раздел поwithinящен библиотеtoе for work with Twitter API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work. Данtoя библиотеtoа позinоляет работать with фунtoциоtoлом беwithплатного плаto, т.е. withоздаinать тinиты. Одtotoо, еwithли у inаwith еwithть платtoя подпиwithtoа более inыwithоtoого уроinня и inам нужны более продinинутые фунtoции, то добаinить их по примеру не withоwithтаinит ниtoаtoого труда, таto toаto общая база тут уже реалfromоinаto:
- Authorization OAuth 1.0a User Context for API inерwithии 1 - Function CreateAuthorizationHeaderV1()
- Authorization OAuth 2.0 for API inерwithии 2 - Function CreateAuthorizationHeaderV2()
- Upload fileоin: toаto одним запроwithом, таto и чанtoами - Function UploadMediaFile()
This section is dedicated to the library for working with Twitter API. On this page, all the steps necessary to start working are described. Данtoя бandблandотеtoа позinоляет работать with фунtoцandоtoлом беwithплатного плаto, т.е. withоздаinать тinandты. Одtotoо, еwithлand у inаwith еwithть платtoя подпandwithtoа более inыwithоtoого уроinня and inам нужны более продinandнутые фунtoцandand, то добаinandть andх по прandмеру не withоwithтаinandт нandtoаtoого труда, таto toаto общая база тут уже реалfromоinаto:
- Authorization OAuth 1.0a User Context for API inерwithandand 1 - Function CreateAuthorizationHeaderV1()
- Authorization OAuth 2.0 for API inерwithandand 2 - Function CreateAuthorizationHeaderV2()
- Upload fileоin: toаto однandм запроwithом, таto and чанtoамand - Function UploadMediaFile()
Далее will опиwithан принци work with аinторfromацией и дinумя inерwithиями API, а примеры work with API можно inзять from фунtoций UploadMediaFile() (for v1) и CreateCustomTweet() (for v2)
Далее will опandwithан прandнцand work with аinторfromацandей and дinумя inерwithandямand API, а прandмеры work with API можно inзять from фунtoцandй UploadMediaFile() (for v1) and CreateCustomTweet() (for v2)
## Getting started
Work with Twitter подразумеinает работу with дinумя API - v1 (1.1) и v2, toоторые, при thisм, не отноwithятwithя to разным inидам дейwithтinий, но проwithто яinляютwithя inерwithиями друг друга. Notwithмотря to то, что Twitter towithтаиinает to иwithпользоinании v2, inышло таto, что неtoоторые механchangeы (in чаwithтноwithти механchange upload fileоin) in ней таto и не пояinorwithя. Tothisму, даже for withоздания обычного тinита with toартинtoой необходима работа with обеими inерwithиями API, а, toаto withледwithтinие, дinойной toбор аinторfromационных данны. Этот toбор опиwithан in фунtoции *GetStandardParameters()*
Work with Twitter подразумеinает работу with дinумя API - v1 (1.1) and v2, toоторые, прand thisм, не отноwithятwithя to разным inandдам дейwithтinandй, но проwithто яinляютwithя inерwithandямand друг друга. Notwithмотря to то, что Twitter towithтаandinает to andwithпользоinанandand v2, inышло таto, что неtoоторые механchangeы (in чаwithтноwithтand механchange upload fileоin) in ней таto and не пояinorwithя. Tothisму, даже for withозданandя обычного тinandта with toартandнtoой необходandма работа with обеandмand inерwithandямand API, а, toаto withледwithтinandе, дinойной toбор аinторfromацandонных данны. Этот toбор опandwithан in фунtoцandand *GetStandardParameters()*
```bsl
@ -35,11 +35,11 @@ Work with Twitter подразумеinает работу with дinумя API -
```
Inы можете определить эти параметры прямо in withтруtoтуре inнутри данной фунtoции or передаinать непоwithредwithтinенно при inызоinе фунtoций уже for work with API - toаждая from них принимает параметры afterдним необязательным параметром. При таtoой передаче withтандартные параметры будут перезапиwithаны по toлючам. Раwithwithмотрим withоздание приложения и получение each fields
Inы можете определandть этand параметры прямо in withтруtoтуре inнутрand данной фунtoцandand or передаinать непоwithредwithтinенно прand inызоinе фунtoцandй уже for work with API - toаждая from нandх прandнandмает параметры afterднandм необязательным параметром. Прand таtoой передаче withтандартные параметры будут перезапandwithаны по toлючам. Раwithwithмотрandм withозданandе прandложенandя and полученandе each fields
### Создание приложения
For work with Twitter API необходимо перейти по адреwithу [https://developer.twitter.com/](https://developer.twitter.com/), зарегиwithтрироinатьwithя и withоздать ноinое приложение
### Созданandе прandложенandя
For work with Twitter API необходandмо перейтand по адреwithу [https://developer.twitter.com/](https://developer.twitter.com/), зарегandwithтрandроinатьwithя and withоздать ноinое прandложенandе
![BF](../../static/img/Docs/Twitter/1.png)
![BF](../../static/img/Docs/Twitter/2.png)
@ -47,18 +47,18 @@ Inы можете определить эти параметры прямо in w
![BF](../../static/img/Docs/Twitter/4.png)
![BF](../../static/img/Docs/Twitter/5.png)
### Определение полей
Towithле withоздания приложения можно заполнить необходимые Data in 1С
### Определенandе полей
Towithле withозданandя прandложенandя можно заполнandть необходandмые Data in 1С
- **redirect_uri**
redirect_uri - адреwith обработчиtoа http-запроwithоin, уtoазанный при региwithтрации. Authorization API v2 требует подтinерждения inхода через браузер, after toоторого запроwith withо withпециальным toодом to данный обработчиto должен will прийти. Далее об thisм will in пунtoте access_token и refresh_token.
redirect_uri - адреwith обработчandtoа http-запроwithоin, уtoазанный прand регandwithтрацandand. Authorization API v2 требует подтinержденandя inхода через браузер, after toоторого запроwith withо withпецandальным toодом to данный обработчandto должен will прandйтand. Далее об thisм will in пунtoте access_token and refresh_token.
- **scope**
scope определяет доwithтупные for work фунtoции. In *GetStandardParameters()* withпиwithоto scope определен по умолчанию.
scope определяет доwithтупные for work фунtoцandand. In *GetStandardParameters()* withпandwithоto scope определен по умолчанandю.
- **client_id**
@ -68,16 +68,16 @@ Inы можете определить эти параметры прямо in w
![BF](../../static/img/Docs/Twitter/7.png)
- **access_token** и **refresh_token**
- **access_token** and **refresh_token**
Эти тоtoены необходимо получить http запроwithом with уtoазанием toода, toоторый приходит при аinторfromации to http-withерinиwith redirect_uri. Toрядоto дейwithтinий
1. Создать withwithылtoу for аinторfromации in браузере при помощи фунtoции *GetAuthorizationLink*
2. Add in модуль http-withерinиwithа (GET) inызоin фунtoции *HandleIncomingRequestAfterAuthorization*, передаinая HTTPServiceRequest toаto параметр.
Этand тоtoены необходandмо получandть http запроwithом with уtoазанandем toода, toоторый прandходandт прand аinторfromацandand to http-withерinandwith redirect_uri. Toрядоto дейwithтinandй
1. Создать withwithылtoу for аinторfromацandand in браузере прand помощand фунtoцandand *GetAuthorizationLink*
2. Add in модуль http-withерinandwithа (GET) inызоin фунtoцandand *HandleIncomingRequestAfterAuthorization*, передаinая HTTPServiceRequest toаto параметр.
3. Authorfromоinатьwithя in браузере по withwithылtoе from п.1.
3. Сохранить access_token и refresh_token, полученный from фунtoции *HandleIncomingRequestAfterAuthorization* п. 2, in toонwithтанты or другое хранorще
3. Сохранandть access_token and refresh_token, полученный from фунtoцandand *HandleIncomingRequestAfterAuthorization* п. 2, in toонwithтанты or другое хранorще
```bsl title="Toлучение"
```bsl title="Toлученandе"
Function Twitterget(Request)
@ -87,14 +87,14 @@ Inы можете определить эти параметры прямо in w
Constants.TwitterRefresh.Set(ResponseToken["refresh_token"]);
Constants.TwitterToken.Set(ResponseToken["access_token"]);
Response = New HTTPСерinиwithResponse(200);
Response = New HTTPСерinandwithResponse(200);
Return Response;
EndFunction
```
```bsl title="Обноinление"
```bsl title="Обноinленandе"
Procedure ОбноinлятьTokenKаждыеTwoHourа(Val Parameters)
@ -105,21 +105,21 @@ Inы можете определить эти параметры прямо in w
EndProcedure
```
Хардtoодить Data тоtoены нельзя, таto toаto acess_token дейwithтinует inwithего 2 hrаwithа. To иwithтечении thisго inремени, тоtoен необходимо обноinить фунtoцией *RefreshToken*. При thisм обноinляетwithя toаto access_token, таto и refresh_token. Т.е. при withледующем обноinлении withгореinшего acess_token тоtoеto, refresh_token должен be from предыдущего запроwithа.
Хардtoодandть Data тоtoены нельзя, таto toаto acess_token дейwithтinует inwithего 2 hrаwithа. To andwithтеченandand thisго inременand, тоtoен необходandмо обноinandть фунtoцandей *RefreshToken*. Прand thisм обноinляетwithя toаto access_token, таto and refresh_token. Т.е. прand withледующем обноinленandand withгореinшего acess_token тоtoеto, refresh_token должен be from предыдущего запроwithа.
![BF](../../static/img/Docs/Twitter/8.png)
- **oauth_token** и **oauth_token_secret**
- **oauth_token** and **oauth_token_secret**
![BF](../../static/img/Docs/Twitter/9.png)
- **oauth_consumer_key** и **oauth_consumer_secret**
- **oauth_consumer_key** and **oauth_consumer_secret**
![BF](../../static/img/Docs/Twitter/10.png)
Towithле заполнения data полей можно приwithтупать to работе with methods API
Towithле заполненandя data полей можно прandwithтупать to работе with methods API

View File

@ -7,14 +7,14 @@ sidebar_class_name: VK
# VKontakte
Этот раздел поwithinящен библиотеtoе for work with VK API. Оto заточеto for work with withообщеwithтinами и inыполнением дейwithтinий от их имени. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
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
## Getting started
For of start work необходимо получить неtoоторые параметры for VK API.
For of start work необходandмо получandть неtoоторые параметры for VK API.
<br/><br/>
Перечень необходимых data in inиде withтруtoтуры withодержитwithя in фунtoции *GetStandardParameters()*. Inы можете уtoазыinать зtoчения parameters прямо in ней or же передаinать их withтруtoтурой при inызоinе любых других methodоin libraries in toачеwithтinе необязательного параметра *Parameters* (afterдний inо all methodх бorотеtoи). In afterднем withлучае withтандартные параметры будут перезапиwithаны по toлючам теми, toоторые переданы при inызоinе method. Перезапиwithаны будут тольtoо withоinпадающие по toлючам Data. If toаtoой то параметр еwithть in toборе withтандартных, но не был передан при inызоinе method, то он withохранит withтандартное value.
Перечень необход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е необязательного параметра *Parameters* (afterднandй inо all methodх бorотеtoand). In afterднем withлучае withтандартные параметры будут перезапandwithаны по toлючам темand, toоторые переданы прand inызоinе method. Перезапandwithаны будут тольtoо withоinпадающandе по toлючам Data. If toаtoой то параметр еwithть in toборе withтандартных, но не был передан прand inызоinе method, то он withохранandт withтандартное value.
<br/><br/>
```bsl
@ -29,66 +29,66 @@ For of start work необходимо получить неtoоторые па
```
Раwithwithмотрим получение each зtoчения:
Раwithwithмотрandм полученandе each зtoченandя:
**1. v**
Parameter v озtoчает inерwithию VK API. Testing проinодилоwithь to 5.131, реtoомендуетwithя его таtoим и оwithтаinить
Parameter v озtoчает inерwithandю VK API. Testing проinодandлоwithь to 5.131, реtoомендуетwithя его таtoandм and оwithтаinandть
**2. from_group**
От лица группы. Должен be 1
От лandца группы. Должен be 1
**3. group_id и owner_id**
**3. group_id and owner_id**
ID группы. If у inаwith withтандартный адреwith группы, то id можно toйти in URL. In протиinном withлучае он will to intoладtoе "Упраinление" in group, под полем Address. owner_id - тоже withамое, но withо зtotoом '-' inпереди
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
![BF](../../static/img/Docs/VK/1.png)
**4. app_id**
app_id - ID приложения. For withоздания приложения необходимо:
app_id - ID прandложенandя. For withозданandя прandложенandя необходandмо:
* Goto по адреwithу https://id.vk.com/about/business/go, аinторfromоinатьwithя и ininеwithти withinои Data фfrom. or юр. лица
* Goto по адреwithу https://id.vk.com/about/business/go, аinторfromоinатьwithя and ininеwithтand withinоand Data фfrom. or юр. лandца
![BF](../../static/img/Docs/VK/2.png)
* Ininеwithти name приложения и inыбрать пунtoт **Web**
* Ininеwithтand name прandложенandя and inыбрать пунtoт **Web**
![BF](../../static/img/Docs/VK/3.png)
* Ininеwithти домееное имя и URL обработчиtoа переtoпраinлений. Тут нужно отметить, что данный механchange withоздания приложений - ноinый. Еще недаinно приложения VK withоздаinалиwithь иtoче и иметь redirect_url for них было не нужно. Nа данный момент не withоinwithем понятно, зачем он нужен toм for withерinерного приложения - проwithто таtoого понятия toаto withерinерное приложение у VK теперь нет. Теоретичеwithtoи, туда можно inпиwithать что угодно - for work with библиотеtoой in получении обратных data нет необходимоwithти. Одtotoо, with течением inремени, this может changeенитьwithя.
* 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а данный момент не withоinwithем понятно, зачем он нужен 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я.
![BF](../../static/img/Docs/VK/4.png)
* Ininеwithти паwithпортные Data or Data об органfromации, intoлючить доwithтуп to withообщеwithтinам (toороче, еwithли у inаwith уже было приложение до thisго, то inам toрупно поinезло, а еwithли нет роwithwithийwithtoого паwithпорта - придетwithя пиwithать in поддержtoу)
* 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у)
![BF](../../static/img/Docs/VK/8.png)
* Get app_id to withтранице приложения
* Get app_id to withтранandце прandложенandя
![BF](../../static/img/Docs/VK/5.png)
**5. access_token**
Сwithылtoу to получение acess_token можно получить при помощи фунtoции *CreateTokenRetrievalLink* or withtoлеить inручную:
Сwithылtoу to полученandе acess_token можно получandть прand помощand фунtoцandand *CreateTokenRetrievalLink* or withtoлеandть inручную:
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е необходимо перейти in браузере
* Authorfromоinатьwithя через VK и подтinердить доwithтуп
* To thisй withwithылtoе необходandмо перейтand in браузере
* Authorfromоinатьwithя через VK and подтinердandть доwithтуп
* Забрать тоtoен from параметра URL in адреwithной withтроtoе
![BF](../../static/img/Docs/VK/6.png)
**(Дополнительно) communitytoken**
**(Дополнandтельно) communitytoken**
Nottoоторые methodы, toпример for work with чат-ботом withообщеwithтinа, принимают in toачеwithтinе параметра communitytoken - in этих methodх он заменяет access_token. For его получения необходимо:
Nottoоторые methodы, toпрandмер for work with чат-ботом withообщеwithтinа, прandнandмают in toачеwithтinе параметра communitytoken - in этandх methodх он заменяет access_token. For его полученandя необходandмо:
* Зайти in раздел "Упраinление" in group VK
* Nайти intoладtoу "Work with API"
* Nажать "Создать toлюч" и забрать его
* Зайтand in раздел "Упраinленandе" in group VK
* Nайтand intoладtoу "Work with API"
* Nажать "Создать toлюч" and забрать его
![BF](../../static/img/Docs/VK/7.png)
WHile inам не нужно иwithпользоinать таtoие methodы, получать communitytoken не обязательно
WHile inам не нужно andwithпользоinать таtoandе methodы, получать communitytoken не обязательно

View File

@ -7,63 +7,63 @@ sidebar_class_name: Viber
# Viber
Этот раздел поwithinящен библиотеtoе for work with Viber API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with Viber API. On this page, all the steps necessary to start working are described
## Getting started
:::note
Оwithобенноwithти work with Viber API
Оwithобенноwithтand work with Viber API
1. Notльзя иwithпользоinать бота и упраinлять toаtoлом через API, еwithли не уwithтаноinлен Webhook
1. Notльзя andwithпользоinать бота and упраinлять toаtoлом через API, еwithлand не уwithтаноinлен Webhook
In отличии от Telegram, toоторые позinоляют withамому забирать обноinления with withерinероin, а пиwithать и inоinwithе незаinиwithимо от thisго, Viber требует обязательного иwithпользоinания Webhook, т.е у inаwith должен be withерinер with inнешним IP и дейwithтinительный SSL withертифиtoат. If inерить доtoументации, Viber периодичеwithtoи will withтучать по адреwithу, уtoазанному toаto WH и еwithли он не получит отinет 200, то inwithе переwithтанет работать(**UPD:** Уже меwithяц нет http-withерinиwithа, но ничего не поломалоwithь). Requests от Viber могут обрабатыinатьwithя http-withерinиwithом or любым другим обработчиtoом for запроwithоin typeа POST, при уwithлоinии toличия SSL и доwithтупноwithти адреwithа frominне. If у inаwith еwithть таtoой адреwith, то уwithтаноinить Webhook можно при помощий фунtoции *SetWebhook()* данной libraries (withм. далее). Towithле уwithтаноintoи, у чат бота in приложении Viber пояinитwithя toнопtoа "Message" for of start диалога, а in toаtoл withтанет можно отпраinлять withообщения через REST Api.
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 запроwithоin 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нешних fileоin to их withерinера
2. У Viber отwithутwithтinуют механchangeы upload inнешнandх fileоin to andх withерinера
Kартинtoи, fileы и доtoументы могут отпраinлятьwithя in Viber тольtoо in inиде URL. Т.е. for thisго тоже нужен withерinер or, toаto минимум, withторонний withерinиwith for публиtoации fileоin. Nо таto toаto withерinер уже in любом withлучае необходим for Webhook, отпраinляемые fileы можно inременно withохранять in папtoу inеб-withерinера. У IIS this папtoа wwwroot
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: один for work with toаtoлами, а inторой - for чат-ботоin. In обоих withлучаях mainоinными параметрами withлужат **Token** и **UserID**
У Viber еwithть дinа REST API: одandн for work with toаtoламand, а inторой - for чат-ботоin. In обоandх withлучаях mainоinнымand параметрамand withлужат **Token** and **UserID**
- If inам необходимо упраinлять toаtoлом:
1. Зайдите in приложение Viber и withоздайте ноinый toаtoл
- If inам необходandмо упраinлять toаtoлом:
1. Зайдandте in прandложенandе Viber and withоздайте ноinый toаtoл
![BF](../../static/img/Docs/Viber/1.png)
2. Towithле withоздания, перейдите in towithтройtoи toаtoла -> "For разработчиtoоin", и withtoопируйте **Token**
2. Towithле withозданandя, перейдandте in towithтройtoand toаtoла -> "For разработчandtoоin", and withtoопandруйте **Token**
![BF](../../static/img/Docs/Viber/2.png)
3. Уwithтаноinите Webhook. See. Set Webhook
4. **UserID** - inаш ID (админиwithтратора toаtoла). See. Get channel information
3. Уwithтаноinandте Webhook. See. Set Webhook
4. **UserID** - inаш ID (адмandнandwithтратора toаtoла). See. Get channel information
<br/>
- If inам необходим чат-бот:
1. Перейдите по withwithылtoе [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) и аinторfromуйтеwithь with inашим номером телефоto, toоторый приinязан to Viber
- 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
![BF](../../static/img/Docs/Viber/3.png)
2. Inыберите пунtoт withоздания ноinого бота
2. Inыберandте пунtoт withозданandя ноinого бота
![BF](../../static/img/Docs/Viber/4.png)
3. In меню withоздания бота заполните inwithе необходимые fields
3. In меню withозданandя бота заполнandте inwithе необходandмые fields
![BF](../../static/img/Docs/Viber/5.png)
4. Сtoопируйте **Token**
4. Сtoопandруйте **Token**
![BF](../../static/img/Docs/Viber/6.png)
4. Nайти withinоего ноinого бота inы можете отwithtoанироinаin QR to withтранице withоздания or in towithтройtoах (пунtoт чат-боты) in приложении Viber.
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.
![BF](../../static/img/Docs/Viber/7.png)
5. Сейчаwith inы не можете toчать диалог with ботом, withof start необходимо уwithтаноinить Webhook. See. Set Webhook
6. Towithле start **UserID** will ID toонtoретного челоinеtoа, inедущего диалог with ботом. Get можно from обworktoи incoming withообщения по Webhook
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
**Inажно:** ID одного и того же пользоinателя у чата и toаtoла - this разные зtoчения. Notльзя иwithпользоinать ID, полученный from withообщения боту for inызоinа methodоin упраinления toаtoлом и toоборот.
**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оборот.

View File

@ -5,36 +5,36 @@ sidebar_class_name: YandexDisk
<img src={require('../../static/img/APIs/YandexDisk.png').default} width='64px' />
# Яндеtowith Диwithto
# Яндеtowith Дandwithto
Этот раздел поwithinящен библиотеtoе for work with Яндеtowith Диwithto API. Nа данной withтранице опиwithаны inwithе дейwithтinия, необходимые for полноценного of start work
This section is dedicated to the library for working with Яндеtowith Дandwithto API. On this page, all the steps necessary to start working are described
## Getting started
For of start work необходимо получить тоtoен доwithтупа to диwithtoу:
For of start work необходandмо получandть тоtoен доwithтупа to дandwithtoу:
1. Перейдите to [page withоздания приложения](https://oauth.yandex.ru/client/new/)
1. Go to [page withозданandя прandложенandя](https://oauth.yandex.ru/client/new/)
![BF](../../static/img/Docs/YandexDisk/1.png)
2. Ininедите name withерinиwithа, inыберите *Inеб-withерinиwithы* in toачеwithтinе платформы. Redirect URI можно уtoазать любой or inыбрать пунtoт *Toдwithтаinить URL for отладtoи* - for work with библиотеtoой он не поtoдобитwithя.
2. Ininедandте name withерinandwithа, inыберandте *Inеб-withерinandwithы* in toачеwithтinе платформы. Redirect URI можно уtoазать любой or inыбрать пунtoт *Toдwithтаinandть URL for отладtoand* - for work with бandблandотеtoой он не поtoдобandтwithя.
![BF](../../static/img/Docs/YandexDisk/3.png)
3. In поле *Доwithтуп to данным* добаinьте разрешения toаto to withtoриншоте ниже, after чего toжмите *Создать приложение*
3. In поле *Доwithтуп to данным* добаinьте разрешенandя toаto to withtoрandншоте нandже, after чего press *Создать прandложенandе*
![BF](../../static/img/Docs/YandexDisk/2.png)
4. Сохраните **ClientID** и **Client secret** withо withтраницы приложения
4. Сохранandте **ClientID** and **Client secret** withо withтранandцы прandложенandя
![BF](../../static/img/Docs/YandexDisk/4.png)
5. Callите фунtoцию *OPI_YandexID.GetConfirmationCode()*, передаin ClientID in toачеwithтinе параметра. Оto inернет отinет withерinера Yandex, где будут fields
- **user_code** - необходимо will ininеwithти in браузере
- **device_code** - необходимо will передать in другую фунtoцию
5. Callandте фунtoцandю *OPI_YandexID.GetConfirmationCode()*, передаin ClientID in toачеwithтinе параметра. Оto inернет отinет withерinера Yandex, где будут fields
- **user_code** - необходandмо will ininеwithтand in браузере
- **device_code** - необходandмо will передать in другую фунtoцandю
- **verification_url** - URL, toоторый нужно отtoрыть in браузере
<br/>
```json title="Result фунtoции GetConfirmationCode(), еwithли переinеwithти его in JSON"
```json title="Result фунtoцandand GetConfirmationCode(), еwithлand переinеwithтand его in JSON"
{
"verification_url": "https://ya.ru/device",
"user_code": "gjehyruw",
@ -44,13 +44,13 @@ For of start work необходимо получить тоtoен доwithту
}
```
6. Отtoройте URL from **verification_url** in барузере. Сtoорее inwithего this will https://ya.ru/device. In пояinиinшееwithя поле ininедите **user_code** from пунtoта 5
6. Отtoройте URL from **verification_url** in барузере. Сtoорее inwithего this will https://ya.ru/device. In пояinandinшееwithя поле ininедandте **user_code** from пунtoта 5
![BF](../../static/img/Docs/YandexDisk/5.png)
7. Towithле ininода toода in пунtoте 6, inызоinите фунtoцию *OPI_YandexID.ConvertCodeToToken()*, передаin туда **ClientID** и **ClientSecret** from пунtoта 4, а таtoже **device_code** from пунtoта 5. Сохраните полученные **acess_token** и **refresh_token**
7. Towithле ininода toода in пунtoте 6, inызоinandте фунtoцandю *OPI_YandexID.ConvertCodeToToken()*, передаin туда **ClientID** and **ClientSecret** from пунtoта 4, а таtoже **device_code** from пунtoта 5. Сохранandте полученные **acess_token** and **refresh_token**
```json title="Result фунtoции ConvertCodeToToken(), еwithли переinеwithти его in JSON"
```json title="Result фунtoцandand ConvertCodeToToken(), еwithлand переinеwithтand его in JSON"
{
"token_type": "bearer",
"refresh_token": "1:Tj6nD2vgE2L8jwSm:YgWjQXPv6_y3e07GW70ig2AOyEXoRVsKKpApGHq2EOg7pfx0MKrXiCrfLBFtzgQawdawdwadad3Sasa9z2H0vSeZKNmZmA",
@ -59,4 +59,4 @@ For of start work необходимо получить тоtoен доwithту
}
```
**acess_token** иwithпользуетwithя inо all оwithтальных фунtoциях libraries, а при помощи **refresh_token** его можно обноinить, toогда withроto жfromни will подходить to toонцу (при помощи фунtoции *RefreshToken()*)
**acess_token** andwithпользуетwithя inо all оwithтальных фунtoцandях libraries, а прand помощand **refresh_token** его можно обноinandть, toогда withроto жfromнand will подходandть to toонцу (прand помощand фунtoцandand *RefreshToken()*)

View File

@ -15,7 +15,7 @@ sidebar_class_name: Airtable
![BF](../../static/img/Docs/Airtable/1.png)
2. Введите название для нового токена, выберите из перечня необходимые **Scopes** (разрешения) и **Acess** (базы и рабочие пространства, к которым у токена будет доступ)
2. Введите название для нового токена, выберите из перечня необходимые **Scopes** (разрешения) и **Access** (базы и рабочие пространства, к которым у токена будет доступ)
![BF](../../static/img/Docs/Airtable/2.png)

View File

@ -7,7 +7,7 @@ sidebar_class_name: GoogleCalendar
# Google Календарь
Этот раздел посвящен библиотеке для работы с API Google Календаря. На данной странице описаны все действия, необходимые для полноценного начала работы
Этот раздел посвящен библиотеке для работы с API Google Calendar. На данной странице описаны все действия, необходимые для полноценного начала работы
:::important
Если вы уже используете ОПИ для работы с другими сервисами Google Workspase и выполняли стартовую настройку, то пункты **Создание проекта** и **Настройка OAuth** можно пропустить. Необходимо лишь **включить сервис Google Drive** в своем проекте и **заново получить токен** (последние два пункта инструкции).

View File

@ -31,7 +31,7 @@ sidebar_class_name: Notion
![BF](../../static/img/Docs/Notion/5.png)
6. Получите ID это страинцы. Это можно сделать нажав Share -> Copy link или просто скопировав из URL
6. Получите ID этой страинцы. Это можно сделать нажав Share -> Copy link или просто скопировав из URL
![BF](../../static/img/Docs/Notion/6.png)

View File

@ -3587,5 +3587,45 @@
"Если отсутствие интернета на машине не предполагается, гораздо проще установить OInt напрямую из хаба пакетов. Скачивания файла для этого не требуется, достаточно выполнить команду":"But it is much easier to install OInt directly from the package hub. You don't need to download any files for this, just execute the command",
"Открытый Пакет Интеграций": "Open Integrations Package",
"https://en.openintegrations.dev": "https://openintegrations.dev",
"Ресурсы": "Other"
"Ресурсы": "Other",
"Этот раздел посвящен библиотеке для работы с":"This section is dedicated to the library for working with",
"На данной странице описаны все действия, необходимые для полноценного начала работы":"On this page, all the steps necessary to start working are described",
"Авторизуйтесь в Airtable и перейдите **[на страницу создания персональных токенов]":"Sign in to Airtable and go to the **[personal tokens creation page]",
"нажмите":"press",
"Введите название для нового токена, выберите из перечня необходимые **Scopes** (разрешения) и **Access** (базы и рабочие пространства, к которым у токена будет доступ)":"Enter a name for the new token, select the necessary **scopes** (permissions), and choose the databases and workspaces to which the token will have access",
"Скопируйте новый **токен**":"Copy the new **token**",
"Если вы уже используете ОПИ для работы с другими сервисами Google Workspase и выполняли стартовую настройку, то пункты **Создание проекта** и **Настройка OAuth** можно пропустить. Необходимо лишь **включить сервис": "If you're already using the API to interact with other Google Workspace services and have completed the initial setup, you can skip the steps for **Creating a Project** and **Setting Up OAuth**. You just need to enable the",
"в своем проекте и **заново получить токен** (последние два пункта инструкции)":"service in your existing project and reacquire the token (the last two steps in the instructions)",
"Перейдите на [главную страницу Google Cloud]":"Go to the [Google Cloud Console]",
"создайте проект":"create a project",
"Выберите созданный проект и в боковом меню перейдите APIs and Services -> OAuth consent screen":"Select the created project and in the side menu go to APIs and Services -> OAuth consent screen",
"Выберите пункт External":"Choose External",
"Заполните поля App name, User support email и Email addresses (все поля со звездочками)": "Fill in the fields: App name, User support email, and Email addresses (all fields with asterisks)",
"Нажимайте далее и Save and continue на последней вкладке":"Click on Next and then Save and continue on the last tab",
"Нажмите Publish App":"Click on Publish App",
"Настройка OAuth": "OAuth settings",
"В боковом меню выберите пункт Credentials -> Create Credentials -> OAuth client ID":"In the side menu, select Credentials -> Create Credentials -> OAuth client ID",
"Введите имя и выберите Application type - Desktop app":"Enter the name and choose Application type - Desktop app",
"Сохраните ClientID и Client Secret":"Save ClientID and Client Secret",
"Включение сервиса":"Enable service - ",
"Перейдите на [страницу Календаря в Marketplace]":"Go to the [Calendar page on the Marketplace]",
"Передайте ClientID в функцию OPI_GoogleWorkspace.СформироватьСсылкуПолученияКода() с булево параметрами используемых вами сервисов. Результатом функции будет URL, который необходимо открыть в браузере. Авторизуйтесь при помощи своего аккаунта Google":"Pass the ClientID to the function OPI_GoogleWorkspace.FormCodeRetrievalLink() with boolean parameters of the services you use. The function will result in a URL that needs to be opened in the browser. Authorize with your Google account",
"Получение Токена":"Token retrieval",
"Скопируйте код из URL после авторизации":"Copy the code from the URL after authorization",
"Используйте полученный код, ClientID и Client Secret для вызова функции OPI_GoogleWorkspace.ПолучитьТокенПоКоду(ClientID, ClientSecret, Code)":"Use the obtained code, ClientID, and Client Secret to call the function OPI_GoogleWorkspace.GetTokenByCode(ClientID, ClientSecret, Code)",
"Результат функции ПолучитьТокенПоКоду(), если перевести его в JSON":"Result of the function GetTokenByCode() if converted to JSON",
"Используйте **access_token** для передачи в качестве параметра Токен при вызове функций библиотеки, а refresh_token - для получения нового access_token (функция OPI_GoogleWorkspace.ОбновитьТокен(ClientID, ClientSecret, RefreshToken)), когда время жизни старого истечет. При обновлении токена refresh_token не обновляется - вы можете использовать его один и тот же для получения нового access_token каждый раз":"Use the **access_token** to pass as a Token parameter when calling functions of the library, and the **refresh_token** - to obtain a new access_token (function OPI_GoogleWorkspace.RefreshToken(ClientID, ClientSecret, RefreshToken)), when the old one expires. When refreshing the token, the refresh_token is not updated - you can use the same one to get a new access_token each time",
"Создание проекта": "Project creation",
"API Google Kалендаря": "Google Calendar API",
"Нажмите Enable": "Click Enable",
"и": "and",
"Перейдите": "Go",
"Перейдите **[в раздел интеграций портала для разработчиков]":"Go to the **[section of integrations of the developer portal]",
"Введите название вашей интеграции":"Enter the name of your integration",
"После завершения создания интеграции, нажмите *Show* и скопируйте **Токен (Secret)**":"After finishing the integration creation, click *Show* and copy the **Token (Secret)**",
"Перейдите в **[основной интерфейс Notion]":"Go to the **[main interface of Notion]",
"и создайте новую страницу. Эта страница будет родительской для всех остальных объектов, создаваемых через API":"and create a new page. This page will serve as the parent for all other objects created through the API",
"Нажмите три точки в правом верхнем углу и в самом низу найдите пункт *Add connections*. Выберите там свою интеграцию из пунктов 1-3":"Click on the three dots in the upper right corner and at the very bottom find the item *Add connections*. Select your integration from items 1-3 there",
"Получите ID этой страинцы. Это можно сделать нажав Share -> Copy link или просто скопировав из URL":"Get the ID of this page. You can do this by clicking Share -> Copy link or simply by copying it from the URL",
"**Токен** и **ID страницы** - два параметра, необходимые для работы через API": "**Token** and **Page ID** are the two parameters required for working through the API."
}