Секрети

Секрет — ключ API чи пароль, який бот передає іншому сервісу під час запиту зі скрипта. Секрет зберігається в налаштуваннях бота, а не в тексті скрипта, тож його не видно ні в редакторі, ні в експорті ланок.

Як додати

Відкрийте «Налаштування бота → Секрети».
У полі «Новий секрет» вкажіть назву й значення і натисніть «Додати».

Назва — латинські літери, цифри й _, наприклад API_KEY. Значення після збереження не показується: замість нього в полі видно крапки.

Як використати в скрипті

У скрипті секрет пишуть як secret. і назву: secret.API_KEY.

temp.resp = fetch("https://api.example.com/items", {
  headers: {Authorization: "Bearer " + secret.API_KEY}
})

Секрет працює лише в запитах: fetch(...), page_meta(...) і save_image(...). Його можна вставити в адресу, заголовки й тіло запиту. Скрипт, що читає секрет деінде, наприклад key = secret.API_KEY, не збережеться.

Що бачить скрипт

Значення секрету підставляється лише в момент запиту. Скрипт, змінні й прогін скрипта його не бачать:

у прогоні скрипта на місці секрету видно ‹secret.API_KEY›;
якщо сервіс поверне ключ у відповіді (наприклад, повторить заголовки запиту), бот замінить його на текст ‹secret.API_KEY›, перш ніж записати відповідь у змінну. Так ключ не потрапить ні в повідомлення, ні в сесію.

Як замінити чи видалити

Щоб замінити значення, натисніть олівець у полі секрету, введіть нове значення й натисніть «Зберегти значення».
Щоб видалити секрет, натисніть кошик біля його назви. Скрипти, що його використовують, надсилатимуть запити без нього.