Ссылки#

Когда человек отвечает боту фото, видео, аудио или файлом, а ответ записывается в переменную (переключатель «Записать ответ в пользовательскую переменную» в разделе «Дополнительно» блока), в переменную попадает не сам файл, а короткая ссылка на него — вида …/w/bK3x9. Такая же короткая ссылка ведёт на файл экспорта списка бота в Excel.

Метод decodeShortLink превращает такую ссылку в прямую ссылку на файл — чтобы ваша система могла его скачать, не переходя по переадресации.

decodeShortLink#

Возвращает прямую ссылку на файл по короткой ссылке.

curl -X POST "https://watbot.ru/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": "Короткая ссылка не найдена"
}

Раскрываются только ссылки на файлы, и только те, что относятся к вашему боту или к вашему списку — в том числе к списку, заведённому в проекте, а не в боте. Короткие ссылки другого назначения метод не раскрывает. Просроченная ссылка не раскрывается, как и не открывается по переходу.

Ошибки метода (общие — в разделе Ошибки):