Знаете, бывают такие моменты когда человек смотрит тебе в глаза и на полном серьёзе говорит что два плюс два равно стеариновая свечка. Ты открываешь рот и тут же его беспомощно захлопываешь, в полном недоумении а что, собственно, делать дальше. Иллюстрация:
https://www.youtube.com/watch?v=KOO5S4vxi0o.
Так вот, цитата из документации
Discourse -- это та поебень которой сейчас повсеместно заменяют списки рассылки:
Note: For any endpoints not listed you can follow the "reverse engineer the
Discourse API guide" to figure out how to use an API endpoint.
Anything you can do on the site you can also do using the JSON api.
И вот тут момент стеариновой свечки. Спасибо, капитан. Всё что я делаю на ЛЮБОМ сайте в конечном счёте сводится к вызову API (ну да, не обязательно json) который можно посмотреть в Network вкладке инструментов разработчика в браузере. И если почесать репу и поэксперементировать, можно угадать как нужно
поменять параметры/payload чтобы сделать то что я хочу. Я делал это много раз, и многие это делали, но это не API в смысле Application Programming Interface, это просто так устроены клиент-серверные web-приложения.
API -- это нормальная документация, версионность и обратная совместимость. Сегодня потратил полтора часа на то чтобы понять, где взять токен для того чтобы сделать запрос к этому недо-API, и нормального решения так и не нашёл. Зато API работает с кукой из из браузера.
При всей моей неприязни к GitHub, у него и API вменяемый, и кнопка "Create personal token" находится на видном месте.
Жизнь не перестаёт меня удивлять. Каждый раз когда я говорю себе, что я уже видел дно и хуже уже некуда, выясняется что я в корне неправ, и на самом деле существует целое новое измерение хреновости.