Посилання
Коли людина відповідає боту фото, відео, аудіо або файлом, а відповідь записується в змінну (перемикач запису відповіді у змінну користувача в розділі «Додатково» блоку), у змінну потрапляє не сам файл, а коротке посилання на нього — вигляду …/w/bK3x9. Таке саме коротке посилання веде на файл експорту списку бота в Excel.
Метод decodeShortLink перетворює таке посилання на пряме посилання на файл — щоб ваша система могла його завантажити, не переходячи за переадресацією.
decodeShortLink
Повертає пряме посилання на файл за коротким посиланням.
https://watbot.org/api/v1/decodeShortLink| Параметр | Тип | Обов'язковий | Опис |
|---|---|---|---|
url |
рядок | так | Коротке посилання повністю, з https:// і, якщо він є, з параметром ?k=…. Метод бере з нього код після /w/; домен не перевіряється |
curl -X POST "https://watbot.org/api/v1/decodeShortLink" \
-H "Authorization: Bearer ВАШ_КЛЮЧ" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/w/bK3x9"}'
{
"data": {
"url": "https://files.example.com/bots/12345/passport-scan.jpg"
}
}
{
"error": "Коротке посилання не знайдено",
"message": "Коротке посилання не знайдено"
}
Розкриваються лише посилання на файли, і лише ті, що належать вашому боту або вашому списку — зокрема списку, створеному в проєкті, а не в боті. Короткі посилання іншого призначення метод не розкриває. Прострочене посилання не розкривається, як і не відкривається за переходом.
Помилки методу (загальні — у розділі Помилки):
| Код | Коли | Відповідь |
|---|---|---|
403 |
Посилання належить боту або списку іншого акаунта або не прив'язане ні до бота, ні до списку | {"error": "…", "message": "…"} |
404 |
Короткого посилання з таким кодом немає, строк його дії минув, не підійшов ключ ?k= або видалено список, до якого воно веде |
{"error": "…", "message": "…"} |
422 |
Посилання веде не на файл | {"error": "…", "message": "…"} |
422 |
url не передано, це не адреса або в ній немає шляху /w/код |
{"message": "…", "errors": {"url": ["…"]}} |