Opis techniczny
Jak projektuję API i integracje
Projektuję wersjonowany REST i GraphQL ze schematami, paginacją, spójnym JSON błędów i dokumentacją OpenAPI, z której korzysta frontend.
OAuth2, klucze API i limity zapytań chronią powierzchnie publiczne. Odbiorniki webhooków weryfikują podpis i działają idempotentnie - zwłaszcza przy płatnościach i statusach zamówień. Kolejki łagodzą skoki obciążenia, gdy zewnętrzny CRM odpowiada wolno.
Zanim napiszę kod łączący systemy, mapuję pola. Niedopasowane identyfikatory między ERP, CRM i katalogiem generują więcej kosztów niż brak endpointu. Starsze SOAP lub XML owijam adapterami. Integracje oddaję z czytelnymi logami awarii.
Częste zadania w API i integracjach
- Jak zaprojektować REST API z wersjonowaniem i paginacją
- Jak napisać schemat GraphQL i resolvery bez nadmiernego N+1
- Jak udokumentować API w OpenAPI / Swagger
- Jak wdrożyć OAuth2, klucze API i limity zapytań
- Jak zbudować odbiornik webhook z weryfikacją podpisu
- Jak podłączyć CRM lub ERP (HubSpot, Salesforce, Baselinker)
- Jak zmapować pola między systemami przed kodem łączącym
- Jak zrobić idempotentne endpointy płatności i statusów
- Jak owinąć starsze SOAP za nowoczesnym adapterem
- Jak logować awarie integracji, żeby dało się je szybko znaleźć