Skip to content

Причуды чужих API: точка расширения refract #608

Open

Description

@bim-ba

Ты решил 19.11: ядро не вводит свои ошибки поверх неправильной логики чужого API, а такие причуды делаются через точку расширения refract. Осталось решить, где эта точка и как она выглядит.

Вопрос

Как описать причуду чужого API, чтобы ядро ее не знало?

Примеры

API причуда
Yandex Forms forms questions move --position 1 без страницы: ответ 200, вопрос не двигается
Slack Web API любая ошибка - это ответ 200 с {"ok": false, "error": "..."}
GitHub REST 202 «еще считаю» для статистики, нужно повторить
вариант где живет причуда пример
А ключ каталога x-ycli-reply: {error-when: "ok == false"}, ядро читает его как данные Slack описывается одной строкой
Б рукописный перехватчик на ядре, отмеченный в каталоге x-ycli-hook: slack_ok любой код, но на каждом языке свой
В А для типичных причуд, Б для редких -

Рекомендую: В. Типичные причуды (ошибка внутри 200, повтор при 202) пишутся данными один раз для всех языков, редкие - кодом.
Против: две формы для одной задачи. Автору придется каждый раз выбирать между ними.

Бенчмарк «язык × API» проверит это на Slack и GitHub, поэтому тикет ждет его.

Ответ одной строкой: «А», «Б» или «В».

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs:decisionWaiting for an owner decisionpriority:nextDo after the current workwayfinder:grillingWayfinder ticket: a decision settled in conversation with the owner

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions