Представляем стандартные вебхуки: переломный момент в стандартизации и инновациях вебхуков
19 декабря 2023 г.Я очень рад наконец анонсировать стандартные вебхуки! Мы работали над этим почти год с замечательными партнерами. Собираем отзывы, изучаем варианты использования, обсуждаем аспекты спецификации и дорабатываем ее до того, что имеем сегодня.
Он вышел всего несколько дней назад, но уже оказывает влияние на индустрию, внедряется в множество различных инструментов и получает отзывы и вклад от сообщества.
Так что же это такое? Standard Webhooks — это инициатива по стандартизации веб-перехватчиков и улучшению их качества для производителей, потребителей и экосистемы в целом. На практике это набор инструментов и рекомендаций с открытым исходным кодом для простой, безопасной и надежной отправки веб-перехватчиков.
Подробнее об этом можно прочитать на странице https://github.com/standard-webhooks/standard-webhooks или < a href="https://www.standardwebhooks.com/">https://www.standardwebhooks.com/.
Введение
Вебхуки становятся все более популярными и используются многими ведущими компаниями мира для отправки событий пользователям своих API. Однако экосистема фрагментирована: каждый поставщик веб-перехватчиков использует разные реализации и разное качество. Даже высококачественные реализации различаются, что делает их по своей сути несовместимыми. Такая фрагментация причиняет боль поставщикам и потребителям, подавляя инновации.
Для потребителей это означает, что каждый провайдер обрабатывает веб-перехватчики по-разному, заново изучает, как проверять веб-перехватчики, и сталкивается с ошибками при использовании индивидуальных реализаций. Для поставщиков это означает изобретение велосипеда и перепроектирование уже решенных проблем (безопасность, совместимость и т. д.).
Мы предложили простое решение: стандартизировать вебхуки во всей отрасли. Мы систематизировали набор строгих правил использования веб-перехватчиков на основе существующих передовых отраслевых практик.
При создании спецификации мы приняли два важных дизайнерских решения. Во-первых, встречаться с людьми там, где они есть. Это означает, что мы хотели следовать и систематизировать лучшие отраслевые практики, а не изобретать собственные лучшие практики. Во-вторых, не быть слишком строгим и дать людям возможность соответствовать требованиям, не вызывая критических изменений, даже если это означает, что не все реализации получат все преимущества, предоставляемые спецификацией.
Еще один руководящий принцип заключался в том, что лучше иметь широко распространенную отличную спецификацию, чем неиспользованную идеальную. Наша задача — продолжать создавать инструменты, которые облегчат создание соответствующих реализаций, чем несоответствующих.
Почему я так рад
Я чрезвычайно горжусь тем, что мы создали, и думаю, что это может оказать огромное влияние на индустрию (уже начиная). Я также чрезвычайно воодушевлен качеством людей, работающих над этим, и тем, как многому я научился, работая со всеми над этим. Я думаю о вебхуках каждый день, и благодаря своей работе над Svix я видел тысячи различных реализаций в самых разных отраслях; хотя я все еще многому научился из отзывов и точек зрения каждого, а также из процесса написания этой спецификации вместе со всеми.
Поэтому я хотел бы воспользоваться моментом и выразить огромную благодарность коллегам-членам технического руководящего комитета: Брайану Кукси из Zapier, Иван Грасия из Twilio, Хорхе Вивас из Lob, Мэттью МакКлюр из Mux, Нидзико Ёнскай из ngrok, Стоян Димитровски из Supabase и Винсент Ле Гофф< /a> из Конга. Я рад продолжить работу над этим вместе со всеми вами. Большое спасибо всем, кто предоставил отзывы о спецификации: команде Svix, Брайану Краусу, Джеффу Линдсею и многим другим.
Влияние на отрасль
Я твердо верю, что «Стандартные веб-перехватчики» могут сделать с веб-перехватчиками то же, что JWT сделал с аутентификацией API. Наличие общего согласованного протокола позволит различным реализациям взаимодействовать. Это также означает меньше избыточного кода, меньше проблем с безопасностью, а также новые инструменты и инновации в экосистеме.
Мы уже начинаем видеть результаты этой спецификации: ngrok имеет встроенную поддержку стандартных веб-перехватчиков, мы создали несколько инструментов многократного использования, есть набор [библиотек проверки веб-перехватчиков](https://github.com/standard-webhooks/standard-webhooks/tree/main /библиотеки) и многое другое. Это означает, что каждая реализация, совместимая со стандартными веб-перехватчиками, теперь может воспользоваться всеми этими преимуществами без каких-либо дополнительных усилий.
Клиенты Svix изначально совместимы со стандартными веб-перехватчиками, что означает, что клиенты Svix также получают все вышеперечисленные преимущества бесплатно. Кроме того, поскольку экосистема продолжает расти, все совместимые реализации будут работать с еще большим количеством инструментов и сервисов.
В разработке имеется множество дополнительных преимуществ. Например, одним из самых болезненных аспектов вебхуков является проверка подписи (мы постоянно видим это у потребителей наших клиентов). Благодаря стандартным веб-перехватчикам шлюзы API, такие как Kong, могут просто реализовать его на своей стороне, избавляя своих клиентов от хлопот. Например, такие инструменты, как Zapier, также могут иметь встроенную поддержку проверки, что делает ее прозрачной для клиентов.
Есть еще много вариантов использования, которые меня волнуют, но больше всего меня волнуют те варианты использования, о которых мы еще даже не думали. Мне не терпится увидеть, как это воспримет сообщество.
Для получения дополнительной информации, пожалуйста, посмотрите:
- Веб-сайт: https://www.standardwebhooks.com/
- Репозиторий Github (и спецификация): https://github.com/standard-webhooks/standard-webhooks< /а>
Также опубликовано здесь.
Оригинал