Wycofanie interfejsów API REST

Napisane przez Waldemar Axt

Ostatnia aktualizacja 25 dni temu

Nasze dotychczasowe interfejsy API REST są obecnie zastępowane nowoczesnym interfejsem API GraphQL. Na tej stronie podsumowano aktualny stan, terminy wycofania oraz najważniejsze zasady dotyczące okresu przejściowego.

Dostępne interfejsy API REST

  • Interfejs API v1 – dostępny pod adresem /api

  • Interfejs API v2 – dostępny pod adresem /api/v2

Interfejsy API REST w wersji v1 i v2 zostaną wycofane z dniem 28 lutego 2027 r.
Od tej daty interfejsy te nie będą już dostępne.
Prosimy o odpowiednio wczesne zaplanowanie przejścia na nowy interfejs 123 obsługuje interfejs API GraphQL.

Następca: interfejs API 123onsite GraphQL

Nasz interfejs Interfejs API GraphQL jest już dostępny jako nowoczesny, wydajny i ujednolicony interfejs.

Interfejs API GraphQL całkowicie zastępuje dotychczasowe punkty końcowe REST i umożliwia elastyczne wyszukiwanie danych za pomocą jednego schematu.
Działa on już od dłuższego czasu i może być wykorzystywany w środowisku produkcyjnym.

Wyjątki dotyczące API v2

Niektóre ścieżki API v2 nie są objęte wycofaniem i na razie pozostają aktywne.

Wszystkie ścieżki znajdujące się pod poniższymi ścieżkami pozostaną zachowane

  • GET | /api/v2/images

  • GET | /api/v2/master/files

  • GET | /api/v2/files/

Jeśli brakuje Ci jakichś ścieżek na tej liście, skontaktuj się z naszym zespołem Pomoc techniczna, abyśmy mogli je sprawdzić i w razie potrzeby dodać do tej listy.

Zalecenia dla programistów

  • Wdrażaj nowe funkcje bezpośrednio w oparciu o Interfejs API GraphQL i skontaktuj się z naszym Pomoc techniczna, jeśli brakuje tam jakichś funkcji.

  • Rozpocznij migrację do interfejsu API GraphQL z odpowiednim wyprzedzeniem.

  • Sprawdź wszystkie istniejące integracje, które korzystają z punktów końcowych REST.

  • Korzystaj z dokumentacji GraphQL oraz narzędzia graphiQL podczas testów i prac programistycznych.