Udostępniliśmy interface dla programistów. Pozwala on komunikować się z wyszukiwarką i wzbogacić Wasze programy o możliwość wyszukiwania i pobierania napisów.
Jeżeli jesteś dobrym programistą na pewno zrozumiesz tą krótką specyfikację.
Obecnie udostępnione są dwa skrypty, zwracające wyniki w formacie XML. W pierwszym kroku należy wywołać skrypt:
http://napisy.info/plugin/SzukajTytulow.xml?sid=NiCEPlayer&t=Tytul+filmu
Po zanalizowaniu jego zawartości można wyświetlić listę znalezionych tytułów (lub przetwarzać dalej automatycznie - co kto woli, wszystko zależy od inwencji).
Można wywołać drugi skrypt:
http://napisy.info/plugin/SzukajNapisow.xml?sid=NiCEPlayer&to=Oryginalny+Tytul&tp=Polski+Tytul&k=komendy
W jego odpowiedzi otrzymujemy listę plików do wybranego tytułu (Tytułu muszą być dokładnie takie jak w odpowiedzi na zapytanie do pierwszego skryptu). Jednym z parametrów jest ID więc śmiało można pobrać plik:
http://napisy.info/napisy_info_[tutaj ID].zip
Interface powstał głównie z myślą o rozszerzaniu możliwości odtwarzaczy, ale może być używany także w innych aplikacjach.
ZABRANIAMY! Używania tych skryptów na innych stronach WWW np. do tworzenia 'własnych' wyszukiwarek napisów.
Kilka detali
Jako parametr sid należy podać swój unikatowy identyfikator, MyPlayer czy coś w tym stylu, nawet KaczorDuffy. UNIKATOWY. Obecnie z pluginu korzystać może każdy, ale w przypadku, gdy stwierdzimy masowe naruszenia i brak umiaru - będzie wprowadzona jakaś autoryzacja.
Pominięcie parametru sid powoduje generowanie przykładowego wyniku.
Parametry tytułu muszą być zakodowane do postaci URL.
Pierwszy skrypt przyjmuje polecenia dodatkowe w tytule, to znaczy ze do t= wpisujemy ewentualne dodatkowe komendy +pl +1cd itp. jako część tego łańcucha.
Drugi skrypt wymaga oddzielenia tych komend i przypisania ich do k= oddzielone przecinkami. (np. k=1cd,pl)
I to tyle. W razie pytań - piszcie. Pamiętajcie, że można sprytnie żonglować parametrami +ileCD, +PL, +inf:co w info, ograniczając wyniki i w efekcie dialog z użytkownikiem.
Z naszej strony 2 prośby:
- Umieść linka do napisy.info
- Jeżeli Twój program to odtwarzacz, wyświetlaj po zakończeniu filmu prośbę o skomentowanie napisów (i ewentualnie otwieraj stronę http://www.napisy.info/Napisy[tutaj ID].html
To do:
- Więcej poleceń :]
- Graficzne elementy 'powered by NAPiSY.info'
