Работа с базой данных

Обновлено 8 февраля 2024

Graph

База данных позволяет сохранять, читать и удалять любые данные, привязанные к пользователю смартапа.

Сервис доступен по адресу.

Обратите внимание: данный сервис является простым key-value хранилищем и не предполагает дополнительной авторизации или защиты данных. Ответственность за данные, переданные в сервис, лежит на разработчике.

С помощью сервиса вы можете попрактиковаться в разработке бота, но он не является базой знаний для полноценных приложений.

Если для развития вашего проекта требуются более широкие возможности, рекомендуем использовать специализированные сторонние решения баз данных с поддержкой REST API.

Запись данных

Чтобы записать данные в базу:

1. Создайте в сценарии блок HTTP-запрос.
2. Выберите метод POST.
3. В поле URL укажите адрес базы данных пользователя: https://smartapp-code.sberdevices.ru/tools/api/v2/data.

Поля вкладки RESPONSE заполнять не надо.

4. В поле вкладки BODY укажите JSON-объект с данными, которые надо сохранить. Например:

   {
       "var1": "value",
       "var2": 100,
       "var3": [1, 2, 3]
   }
   

5. На вкладке HEADERS укажите заголовок userId со значением $userId.

Чтение данных

Чтобы прочитать данные из базы:

1. Создайте в сценарии блок HTTP-запрос.
2. Выберите метод GET.
3. В поле URL укажите адрес базы данных пользователя: https://smartapp-code.sberdevices.ru/tools/api/v2/data.

Успешные ответы сохраняются в переменной $httpResponse.

4. На вкладке RESPONSE создайте переменную, в которой будет сохранен ответ.

   Чтобы создать переменную, укажите ее имя, например, varName и значение $httpResponse.

5. На вкладке HEADERS укажите заголовок userId со значением $userId.

Поля вкладок BODY заполнять не надо.

Полученные в результате запроса данные сохраняются в переменной $httpResponse. При отсутствии данных запрос вернет ошибку 404.

Для доступа к полям ответа используйте точечную нотацию:

$varName.<название_поля>

Например, если база данных содержит JSON-объект вида:

{
    "var1": "value",
    "var2": 100,
    "var3": [1, 2, 3]
}

Обращение к $varName.var1 вернет значение value.

Удаление данных

Чтобы удалить все данные пользователя:

1. Создайте в сценарии блок HTTP-запрос.
2. Выберите метод DELETE.
3. В поле URL укажите адрес базы данных пользователя: https://smartapp-code.sberdevices.ru/tools/api/v2/data.

4. На вкладке HEADERS укажите заголовок userId со значением $userId.

   Поля вкладок RESPONSE и BODY заполнять не надо.