Tag: dodawarki

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 »

Od jakiegoś czasu niektórzy właściciele katalogów na iDir otrzymują prośbę od twórców pewnej dodawarki o przesłanie zrzutu SQL z listą ID kategorii. Autor dodawarki tłumaczy to koniecznością posiadania tych ID do celów dodawania wpisów. Jest to rozwiązanie wyjątkowo nieefektywne gdyż:

• każdy katalog ma inną bazę kategorii, jeśli dodawarka będzie dodawać do powiedzmy 1mln katalogów, a każdy z nich ma po 300 kategorii dodawarka będzie musiała przechowywać w swojej bazie 300mln rekordów samych kategorii
• tabela kategorii nie jest stała. Właściciel każdego katalogu może w pewnym momencie w przyszłości usunąć jakąś kategorię co poskutkuje tym, że dodawarka dodając do takiego nieistniejącego ID otrzyma walidacyjny komunikat o nieprawidłowej kategorii

Jeśli mimo wszystko chcą Państwo udostępnić autorom tej bezsensownej z mojego punktu widzenia - dodawarki listę ID swoich kategorii proszę postępować według poniższej instrukcji:

1. Wejść do phpMyAdmin (dane logowania znajdują się w pliku ENV), wybrać bazę katalogu, wybrać zakładkę SQL lub Kwerenda
2. Wkleić i wykonać:
   

   SELECT `categories`.`id`, `categories`.`name`, `categories`.`parent_id` FROM `categories` WHERE `categories`.`status` = 1 AND `categories`.`model_type` = "N1ebieski\\IDir\\Models\\Dir" ORDER BY `categories`.`parent_id` ASC;

3. Na samym dole w belce "Operacje na wynikach zapytania" kliknąć Eksport
4. Wybrać metoda eksportu: szybka; format: SQL, kliknąć Wykonaj