Вызов необёрнутого эндпоинта¶
ycli api PATH --service tracker|wiki|forms вызывает любой эндпоинт сервиса — так же, как это делает
gh api: с той же аутентификацией, повторами, выводом и
кодами возврата, что и у остальных команд.
ycli api issues/TRACKER-1 --service tracker --jq .summary # GET по умолчанию
ycli api issues/TRACKER-1/comments --service tracker -F text=@note.md # поле превращает запрос в POST
ycli api pages/descendants --service wiki -f slug=docs --paginate # все страницы одним JSON-массивом
PATHзадаётся относительно базового URL сервиса. Полному URL сервиса--serviceне нужен; любой другой хост отклоняется, поэтому токен не уходит за пределы Яндекса.-f key=valueотправляет строку;-F— типизированное значение:true,null, числа, JSON,@file— текст файла,key[sub]=v— вложенное поле,key[]=v— элемент массива.- Поля запроса GET или DELETE уходят в строку запроса, во всех остальных случаях — в JSON-тело.
--input FILEотправляет вместо этого тело как есть. -H 'Name: value'добавляет заголовок, а-Xзадаёт метод.--dry-run,--yesи--jqработают так же, как везде.--paginateидёт поLink: rel="next"в Трекере и поnext_cursorв Вики. Формы разбивают списки на страницы несколькими способами, поэтому параметры постраничной выдачи передавайте сами через-f.
Полный список опций — в справочнике по ycli api.