Pracuj\u0119 z firmami B2B od lat i widz\u0119 ten sam schemat: buduj\u0105 \u015bwietne produkty, ale zapominaj\u0105 o API. A potem dziwi\u0105 si\u0119, \u017ce klienci odchodz\u0105. W dzisiejszych czasach API to nie tylko techniczny detal \u2013 to wizyt\u00f3wka Twojej firmy. Je\u015bli jest \u017ale zaprojektowane, kosztuje Ci\u0119 kontrakty, zaufanie i czas. W tym artykule poka\u017c\u0119 trzy najcz\u0119stsze b\u0142\u0119dy, kt\u00f3re pope\u0142niaj\u0105 nawet do\u015bwiadczone zespo\u0142y. I co wa\u017cniejsze \u2013 jak je naprawi\u0107.<\/p>\n
Klient B2B, kt\u00f3ry integruje si\u0119 z Twoim API, potrzebuje jasnej, aktualnej i kompletnej dokumentacji. Bez niej ka\u017cda integracja staje si\u0119 loteri\u0105. Pami\u0119tam przypadek jednej platformy SaaS, kt\u00f3ra straci\u0142a kluczowego kontrahenta, bo ich dokumentacja by\u0142a rozsiana po trzech r\u00f3\u017cnych narz\u0119dziach, a endpointy zmienia\u0142y si\u0119 bez ostrze\u017cenia. Zesp\u00f3\u0142 klienta sp\u0119dzi\u0142 dwa tygodnie na debugowaniu, po czym zrezygnowali.<\/p>\n
Rozwi\u0105zanie:<\/strong> Zadbaj o dokumentacj\u0119 w formacie OpenAPI\/Swagger. Utrzymuj j\u0105 jako \u017cywy dokument \u2013 ka\u017cda zmiana w API powinna by\u0107 od razu odzwierciedlona. Wersjonuj endpointy (np. Rekomendacja JurskiTech:<\/strong> Regularnie przegl\u0105daj logi b\u0142\u0119d\u00f3w i zbieraj feedback od integrator\u00f3w. Je\u015bli widzisz powtarzaj\u0105ce si\u0119 pytania \u2013 uzupe\u0142nij dokumentacj\u0119.<\/p>\n B2B cz\u0119sto oznacza du\u017ce wolumeny danych. Je\u015bli nie okre\u015blisz limit\u00f3w na zapytania, jeden agresywny klient mo\u017ce przeci\u0105\u017cy\u0107 ca\u0142y system. Albo gorzej \u2013 atak DDoS zepsuje reputacj\u0119 wszystkim. Znam startup, kt\u00f3ry nie zastosowa\u0142 rate limitingu i po nieudanej pr\u00f3bie synchronizacji przez wa\u017cnego partnera, ich infrastruktura pad\u0142a na 3 godziny. Klient odszed\u0142 do konkurencji.<\/p>\n Rozwi\u0105zanie:<\/strong> Wprowad\u017a limity (np. 1000 zapyta\u0144 na minut\u0119), zwracaj kody HTTP 429 z nag\u0142\u00f3wkiem Rekomendacja JurskiTech:<\/strong> Monitoruj u\u017cycie API i alarmuj zesp\u00f3\u0142, gdy kt\u00f3ry\u015b z klient\u00f3w zbli\u017ca si\u0119 do limitu. Przezroczysto\u015b\u0107 buduje zaufanie.<\/p>\n Wielokrotnie widzia\u0142em API, kt\u00f3re nie sprawdza\u0142y uprawnie\u0144 na poziomie zasob\u00f3w. Przyk\u0142ad: SaaS do zarz\u0105dzania projektami. Dzi\u0119ki b\u0142\u0119dnej autoryzacji u\u017cytkownik z jednej firmy m\u00f3g\u0142 odczyta\u0107 projekty innej firmy, zmieniaj\u0105c tylko ID w URL. Firma dowiedzia\u0142a si\u0119 o tym od klienta, kt\u00f3ry zg\u0142osi\u0142 wyciek danych. Kosztowa\u0142o to utrat\u0119 kontrakt\u00f3w i proces s\u0105dowy.<\/p>\n Rozwi\u0105zanie:<\/strong> Zaimplementuj autoryzacj\u0119 na ka\u017cdym endpointie. U\u017cywaj standard\u00f3w OAuth 2.0 lub JWT. Nie ufaj, \u017ce klient nie b\u0119dzie manipulowa\u0142 ID. Zawsze sprawdzaj, czy \u017c\u0105daj\u0105cy jest w\u0142a\u015bcicielem zasobu. Regularnie testuj (np. OWASP ZAP).<\/p>\n Rekomendacja JurskiTech:<\/strong> Przeprowad\u017a audyt bezpiecze\u0144stwa API z u\u017cyciem narz\u0119dzi automatyzuj\u0105cych. Lepiej znale\u017a\u0107 b\u0142\u0105d wewn\u0119trznie ni\u017c po skardze klienta.<\/p>\n API to nie tylko technologia \u2013 to obietnica jako\u015bci, kt\u00f3r\u0105 sk\u0142adasz swoim klientom B2B. Je\u015bli zaniedbasz dokumentacj\u0119, throttling i autoryzacj\u0119, ryzykujesz utrat\u0119 zaufania, czasu i pieni\u0119dzy. A w \u015bwiecie B2B odzyskanie partnera jest cz\u0119sto niemo\u017cliwe. Zadbaj o te trzy obszary ju\u017c dzi\u015b.<\/p>\n Je\u015bli potrzebujesz pomocy w audycie lub projektowaniu API, zesp\u00f3\u0142 JurskiTech ma do\u015bwiadczenie w budowaniu skalowalnych i bezpiecznych rozwi\u0105za\u0144 dla firm B2B. Ch\u0119tnie doradzimy.<\/p>\n","protected":false},"excerpt":{"rendered":" 3 b\u0142\u0119dy w strategii API, kt\u00f3re zabijaj\u0105 Tw\u00f3j biznes B2B Pracuj\u0119 z firmami B2B od lat i widz\u0119 ten sam schemat: buduj\u0105 \u015bwietne produkty, ale zapominaj\u0105 o API. A potem dziwi\u0105 si\u0119, \u017ce klienci odchodz\u0105. W dzisiejszych czasach API to nie tylko techniczny detal \u2013 to wizyt\u00f3wka Twojej firmy. Je\u015bli jest \u017ale zaprojektowane, kosztuje Ci\u0119<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[699,4,617,683],"class_list":["post-2153","post","type-post","status-publish","format-standard","hentry","category-warto-wiedziec","tag-api-gateway","tag-automatyzacja","tag-b2b-saas","tag-bezpieczenstwo-ai"],"_links":{"self":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2153","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/comments?post=2153"}],"version-history":[{"count":0,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2153\/revisions"}],"wp:attachment":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/media?parent=2153"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/categories?post=2153"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/tags?post=2153"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\/v1\/resource<\/code> i \/v2\/resource<\/code>), aby nie \u0142ama\u0107 istniej\u0105cych integracji. Tw\u00f3j klient nie mo\u017ce by\u0107 zaskoczony.<\/p>\n2. Pomijanie limit\u00f3w i throttlingu \u2013 zaproszenie do chaosu<\/h2>\n
Retry-After<\/code>. U\u017cywaj bazark\u00f3w token\u00f3w (Token Bucket) dla precyzji. Daj klientom mo\u017cliwo\u015b\u0107 wykupienia wy\u017cszego limitu \u2013 to te\u017c model monetyzacji.<\/p>\n3. Zapominanie o autoryzacji \u2013 drzwi otwarte dla w\u0142amywaczy<\/h2>\n
Podsumowanie<\/h2>\n