diff --git a/docs/docs/Nachalo-raboty.md b/docs/docs/Nachalo-raboty.md index 502ff5b92f..79a08262ea 100644 --- a/docs/docs/Nachalo-raboty.md +++ b/docs/docs/Nachalo-raboty.md @@ -17,6 +17,7 @@ sidebar_position: 1 <a href="/docs/Viber/"><img src={require('../static/img/APIs/Viber.png').default} width='32px'/> </a> <a href="/docs/Twitter/"><img src={require('../static/img/APIs/Twitter.png').default} width='32px'/> </a> <a href="/docs/Notion/"><img src={require('../static/img/APIs/Notion.png').default} width='32px'/> </a> +<a href="/docs/Yandex Disk/"><img src={require('../static/img/APIs/YandexDisk.png').default} width='32px'/> </a> ## Начало работы diff --git a/docs/docs/Yandex Disk/Yandex Disk.md b/docs/docs/Yandex Disk/Yandex Disk.md new file mode 100644 index 0000000000..a984020a3b --- /dev/null +++ b/docs/docs/Yandex Disk/Yandex Disk.md @@ -0,0 +1,61 @@ +--- +id: YandexDisk +--- + +<img src={require('../../static/img/APIs/YandexDisk.png').default} width='64px' /> + +# Яндекс Диск + +Этот раздел посвящен библиотеке для работы с Яндекс Диск API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +Для начала работы необходимо получить токен доступа к диску: + +1. Перейдите на [страницу создания приложения](https://oauth.yandex.ru/client/new/) + + + +2. Введите название сервиса, выберите *Веб-сервисы* в качестве платформы. Redirect URI можно указать любой или выбрать пункт *Подставить URL для отладки* - для работы с библиотекой он не понадобится. + + + +3. В поле *Доступ к данным* добавьте разрешения как на скриншоте ниже, после чего нажмите *Создать приложение* + + + +4. Сохраните **ClientID** и **Client secret** со страницы приложения + + + +5. Вызовите функцию *ПолучитьКодПодтверждения()*, передав ClientID в качестве параметра. Она вернет ответ сервера Yandex, где будут поля + - **user_code** - необходимо будет ввести в браузере + - **device_code** - необходимо будет передать в другую функцию + - **verification_url** - URL, который нужно открыть в браузере +<br/> + ```json title="Результат функции ПолучитьКодПодтверждения(), если перевести его в JSON" + { + "verification_url": "https://ya.ru/device", + "user_code": "gjehyruw", + "interval": 5, + "expires_in": 300, + "device_code": "12207cafec1b40ad8d0052af3faf0d12" + } + ``` + +6. Откройте URL из **verification_url** в барузере. Скорее всего это будет https://ya.ru/device. В появившееся поле введите **user_code** из пункта 5 + + + +7. После ввода кода в пункте 6, вызовите функцию *ПолучитьТокенПоКодуАвторизации()*, передав туда **ClientID** и **ClientSecret** из пункта 4, а также **device_code** из пункта 5. Сохраните полученные **acess_token** и **refresh_token** + +```json title="Результат функции ПолучитьТокенПоКодуАвторизации(), если перевести его в JSON" +{ + "token_type": "bearer", + "refresh_token": "1:Tj6nD2vgE2L8jwSm:YgWjQXPv6_y3e07GW70ig2AOyEXoRVsKKpApGHq2EOg7pfx0MKrXiCrfLBFtzgQawdawdwadad3Sasa9z2H0vSeZKNmZmA", + "expires_in": 31535956, + "access_token": "y0_AgAAAABWxxdkAAs0QgAAAAD59cawdawdwadadVKIiwGK__crw" +} +``` + +**acess_token** используется во всех остальных функциях библиотеки, а при помощи **refresh_token** его можно обновить, когда срок жизни будет подходить к концу (при помощи функции *ОбновитьТокен()*) \ No newline at end of file diff --git a/docs/docs/Yandex Disk/_category_.json b/docs/docs/Yandex Disk/_category_.json new file mode 100644 index 0000000000..3ae92acca7 --- /dev/null +++ b/docs/docs/Yandex Disk/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Yandex Disk", + "position": 6, + "link": { + "type": "doc", + "id": "YandexDisk" + } +} diff --git a/docs/static/img/APIs/YandexDisk.png b/docs/static/img/APIs/YandexDisk.png new file mode 100644 index 0000000000..e951c4fc8f Binary files /dev/null and b/docs/static/img/APIs/YandexDisk.png differ diff --git a/docs/static/img/Docs/YandexDisk/1.png b/docs/static/img/Docs/YandexDisk/1.png new file mode 100644 index 0000000000..9a4df815c2 Binary files /dev/null and b/docs/static/img/Docs/YandexDisk/1.png differ diff --git a/docs/static/img/Docs/YandexDisk/2.png b/docs/static/img/Docs/YandexDisk/2.png new file mode 100644 index 0000000000..aac4e1baaa Binary files /dev/null and b/docs/static/img/Docs/YandexDisk/2.png differ diff --git a/docs/static/img/Docs/YandexDisk/3.png b/docs/static/img/Docs/YandexDisk/3.png new file mode 100644 index 0000000000..e6ca99decb Binary files /dev/null and b/docs/static/img/Docs/YandexDisk/3.png differ diff --git a/docs/static/img/Docs/YandexDisk/4.png b/docs/static/img/Docs/YandexDisk/4.png new file mode 100644 index 0000000000..6c85f6d0c1 Binary files /dev/null and b/docs/static/img/Docs/YandexDisk/4.png differ diff --git a/docs/static/img/Docs/YandexDisk/5.png b/docs/static/img/Docs/YandexDisk/5.png new file mode 100644 index 0000000000..4c9e340f54 Binary files /dev/null and b/docs/static/img/Docs/YandexDisk/5.png differ