Archiwum: marzec 2022

Jak korzystać z API?

Opublikowano: 2 miesiące 4 dni temu Autor: admin

Od wersji 8.0 iDir oferuje ujednolicone API za pomocą którego można stworzyć automatyczne dodawarki, sprawdzarki albo panele moderacji centralnej. Niniejszy post jest krótkim wprowadzeniem do korzystania z API. Do testowania poszczególnych requestów polecam zaopatrzyć się w darmowy program Postman.

# Import dostępnych enpointów

Mając zainstalowany program Postman, w górnym menu należy wybrać Import, zaznaczyć zakładkę Link i wstawić link z oficjalnej dokumentacji API iDir https://demo.idir.intelekt.net.pl/docs/collection.json.

# Dodawanie nowych wpisów

Domyślnie w iDir dodawanie nowych wpisów dostępne jest zarówno dla zalogowanych użytkowników serwisu jak i gości. W przypadku dodawania wpisów jako gość, wymagane jest dodatkowo podanie unikalnego adresu email. Z racji tego API nie wymaga w tym przypadku autentykacji za pomocą tokena API.

Aby dodać wpis do katalogu należy znać ID grupy. Grupy można wyciągnąć za pomocą endpointu:

pokaż więcej »

Aktualizacja API dla dodawarek

Opublikowano: 2 miesiące 5 dni temu Autor: admin

Aktualizacja 8.0.0 dla iDir i 6.0.0 dla iCore zawiera:

  • dodano panel do generowania tokenów API dla użytkowników w profilu (tokeny służą do uproszczonej autentykacji przy korzystaniu z API)
  • dodano szereg nowych enpointów do API służących do dodawania, edytowania lub usuwania wpisów katalogu stron. Za ich pomocą można zbudować automatyczne dodawarki lub panele moderacji centralnej.
  • przygotowano dokładną dokumentację API przy użyciu narzędzia Laravel Scribe opisującą wszystkie dostępne endpointy wraz z przykładami użycia w różnych językach programowania.
  • dodano obsługę Recaptcha Invisible. Jest to token podobny do zwykłej recaptchy, ale wygodniejszy dla użytkownika, ponieważ potwierdzenie jest zintegrowane z przyciskiem wysyłającym formularz.

Prócz tego ogólna refaktoryzacja kodu i naprawa drobniejszych błędów.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Polecamy zapoznać się również z podstawową instrukcją korzystania z API.