API dla systemu, który ma tylko bazę danych i eksport do CSV
Dokładamy do starego systemu interfejs, z którego mogą korzystać sklep, CRM i aplikacje. Sam system działa dalej bez zmian.
Od zamkniętego systemu do udokumentowanego API
Zaczynamy od tego, czego inne narzędzia naprawdę potrzebują.
- 1Potrzeby odbiorcówSpisujemy, czego chcą sklep, CRM czy aplikacja: które dane, jak często, czy tylko czytać, czy też zapisywać.
- 2Dostęp do systemuWybieramy bezpieczną drogę: istniejące usługi SOAP, procedury w bazie albo odczyt z tabel. Logika systemu zostaje na miejscu.
- 3Nowe APIBudujemy REST albo GraphQL z autoryzacją, limitami i webhookami, które informują o zmianach, zamiast kazać innym pytać co minutę.
- 4Dokumentacja i testyKażdy endpoint ma opis i przykład. Testy kontraktowe pilnują, żeby zmiana w systemie nie zepsuła odbiorców po cichu.
Po czym poznasz, że system potrzebuje API
Każda integracja to osobny eksport
Odpytywanie co minutę
SOAP, którego nikt nie chce
Wymiana systemu nie wchodzi w grę
Z czym pracujemy
Dobieramy sposób do systemu, który już masz.
REST
GraphQL
Nakładki SOAP na REST
Webhooki
Bazy danych
Bezpieczeństwo
Jak sprawdzamy efekt
Przed wdrożeniem liczymy eksporty, ręczne pliki i zapytania do bazy. Po wdrożeniu porównujemy te same liczby.
- 1Eksporty i pliki wymiany
- 2Zapytania obciążające bazę
- 3Integracje podłączone do API
- 4Błędy po zmianach w systemie
Dziennik wywołań pokazuje, kto korzysta z API i jak często.
Częste pytania
Czy musimy zmieniać stary system?
Zwykle nie. API stoi obok systemu i korzysta z mechanizmów, które już ma.
Czy API spowolni system?
Projektujemy je tak, żeby odciążyło bazę: webhooki zamiast odpytywania i pamięć podręczna dla danych, które rzadko się zmieniają.
Kto będzie mógł korzystać z API?
Tylko odbiorcy, którym dasz klucz. Każdy ma własne uprawnienia i widać, co pobiera.
REST czy GraphQL?
Dla większości firm REST. GraphQL proponujemy, gdy kilka aplikacji potrzebuje bardzo różnych danych z tego samego systemu.
Opisz system bez API
Napisz, co to za system, w jakiej technologii działa i co chcecie do niego podłączyć. Odpowiadamy w ciągu jednego dnia roboczego.