API dla programistów programu Napisy24

Uwagi i sugestie na temat działania aplikacji Napisy24.
Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

API dla programistów programu Napisy24

Post autor: Arczi » 01 gru 2014, 0:18

Witam.
Jeżeli ktoś jest zainteresowany API do programu proszę o info na priva z danymi:

1. UserAgent + hasło dostepu - to nazwa Waszego użytkownika który będzie pobierał napisy
2. Nazwa programu (jeżeli będzie dopiero tworzony to jaka mniej więcej będzie jego nazwa)
3. Strona www - jeżeli taka jest.

API jest dopiero tworzone, na początek dostępne będą opcje sprawdzania czy są napisy i ich pobieranie.
(wysyłanie, zgłaszanie błedów, zgłaszanie IMDB, FilmWeb - narazie nie będzie dostępne).

Utworzona aplikacja musi mieć możliwość (wystarczy jeden klawisz) skomentowania napisów (po pobraniu napisów z serwisu kliknięcie w klawisz skomentuj przenosi na stronę www danego napisu w opcji "komentuj")

Z serwerem komunikacja odbywać się będzie za pomocą formularza wysłanego metodą POST.

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 15 sty 2015, 19:01

Poniżej opis API, chciałem zrobić ładnie oparte na róznego rodzaju tablicach ale może nie pięknie ale działa tak jak poniżej:
(chętnych proszę o useragenta i hasło do niego na PW)

adres wywołania (metoda POST):
http://napisy24.pl/run/CheckSubAgent.php

parametry:
postAction='CheckSub' -na stałe string CheckSub
ua=login -useragent
ap=pass -hasło

fh=filehash -hash pliku jak w opensub (mogę podesłać zródła w pascalu) np: A74C3D905E7D8A59
fs=rozmiar -rozmiar pliku rozmiar w bajtach np: 2678822514
md=md5 -MD5 pliku jak w napi (opcjonalnie) np: b746990307f5993ec43e1b566cb259f6
fn=filename -nazwa pliku np: supernatural.avi

parametry opcjonalnie:
nl -język napisów 'pl', 'en'
tb -gdy jest ten parametr nieważne jakiej wartości wysyła napisy tylko gdy są z bazy napisy24.pl
licz -proszę wysyłać tylko przy pierwszym pytaniu o napisy; zlicza ile osób szuka dane napisy
n24pref=1 -preferuj napisy z napisy24; gdy np. napisy są w tłumaczeniu nie zostanie pobrany ten co już jest pewnie gorszej jakości

==============================================
skrypt szuka po hash + rozmiar, gdy nie znajdzie to szuka po md5 jeżeli zostało podane

odpowiedzi:

odpowiedzi to "string" w postaci:

OK-0|| -brak napisów i jakiejkolwiek informacji o napisach czy pliku
OK-1| -brak napisów, ale mamy info w bazie podane po | (opis niżej)
OK-2| -napiy w bazie, wysyła
OK-3| -napisy w bazie ale ustawiony parametr tb więc nie wysyłam, wysyłam tylko informacje o filmie

dalsze informacje wyświetlane po | (wszystko w jednym ciagu oddzielone znakiem |, koniec znakiem ||, jeżeli są napisy są wysłane po znaku ||)

res:1280x720|
time:01:30:00|
fps:23.976|
imdb:1234567|
ilea:5|
ftitle:tytuł filmu|
fyear:2015|
fgenres:crime|
fcover:url obrazka|
fwstawil:kto wstawil|
ftlumacz:tlumaczyl|
fkorekta:korekta|
tlId:tlumaczenieId|
tlPrc:tlumaczenie procent|
tlInfo:info od tłumacza
fcover:link do okładki|
fimdb:imdbid|
napisId:idnapisu w n24|
lp:numer w bazie||


UWAGA1: napisId to identyfikator napisów w napisy24.pl - zalecam mocno aby w programie była możliwośc komentowania napisów czyli zwykły button którego wciśnięcie pokieruje na stronę komentarza danego napisu np:

http://napisy24.pl/komentarze?napisId=82843

UWAGA2: w przypadku gdy napisy nie zostaną znalezione proszę odpytywać serwer o te same napisy w odstępach minimum 15 minutowych!

============================

Programik do testów zapytań pod Windows: http://napisy24.pl/files/CheckSub.exe
Programik do testów zapytań pod Androida: http://napisy24.pl/files/CheckSub.apk

============================

pod poniższym adresem można zobaczyć statystyki swojego programu w formie wykresu:

http://napisy24.pl/run/agents/raport.ph ... ER&ap=PASS

oczywiście zamiast USER i PASS należy wpisać swoje dane.

koob
Posty: 2
Rejestracja: 07 sty 2015, 16:23

Re: API dla programistów programu Napisy24

Post autor: koob » 15 sty 2015, 20:27

Arczi pisze: fh=filehash -hash pliku jak w opensub (mogę podesłać zródła w pascalu)
To będzie to: http://trac.opensubtitles.org/projects% ... ourceCodes ?

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 15 sty 2015, 20:47

tak

user
Posty: 16
Rejestracja: 24 paź 2014, 19:19

Re: API dla programistów programu Napisy24

Post autor: user » 15 sty 2015, 23:40

Arczi pisze: adres wywołania (metoda POST):
http://napisy24.pl/run/CheckSubAgent.php

parametry:
postAction='CheckSub' -na stałe string CheckSub
ua=login -useragent
ap=pass -hasło
mam pytanie, jaki jest tutaj sens w ogóle użycia jakiegoś hasła? przecież można sprawdzić jakie requesty lecą.

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 16 sty 2015, 0:00

niby niepotrzebne, bez większego znaczenia, ale czemu nie, to tylko dwa parametry więcej - bardziej mi tu chodzi o statystyki nie dla seriwsu nawet, ale dla użytkownika - tzn. ja każdemu klientowi dam dostęp do statystyk ile jego program razy pobierał napisy itp.

koob
Posty: 2
Rejestracja: 07 sty 2015, 16:23

Re: API dla programistów programu Napisy24

Post autor: koob » 17 sty 2015, 15:51

Proszę o dodanie jeszcze opcji wyszukiwania po nazwie. Przydałaby się też możliwość określenia zwrotnego formatu opcjonalnie (np. json/xml)

kavillock
Posty: 5
Rejestracja: 16 sty 2015, 20:33

Re: API dla programistów programu Napisy24

Post autor: kavillock » 17 sty 2015, 17:53

również bym prosił o możliwość wyszukania po tytule, przydatne to może być, gdy plik jest lekko uszkodzony lub inaczej skompresowany, a pasują inne napisy, mogło by wtedy oddawać listę informacji wielu napisów pasujących do żądania, ale bez pliku, a później dopiero aby wywołać sam plik, przy takim wywołaniu samego pliku miło by było wybrać wersję pobieranych napisów (subrip, microdvd, itd)

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 17 sty 2015, 21:22

Na zielono zrobiłem małe upgrade, w przypadku gdy napisy są w tłumaczeniach otrzymujemy parametr ile % jest danego napisu przetłumaczone.

dam
Posty: 3
Rejestracja: 17 gru 2014, 12:55

Re: API dla programistów programu Napisy24

Post autor: dam » 25 sty 2015, 21:11

Przydałoby się jeszcze dodać ocenę napisów oraz język(pl, en itp.) w zwracanych danych i możliwość wyboru formatu napisów (sr, tmp itp.) jako kolejny wysyłany parametr.

Ogólnie wg. mnie słaby pomysł z wysyłaniem zipa z napisami jako string pomieszany z resztą odpowiedzi, przykładowo pobierając wynik i konwertując go w całości do utf-8 zip się uszkadza, zdecydowanie lepiej byłoby gdyby zip leciał w base64.

Edit: ponawiam prośbę o wyszukiwanie po nazwie, przykład: używam Kodi jako systemu wbudowanego na HTPC, gdzie do obsługi mam tylko pilota i żadnych innych uruchomionych aplikacji, chcę pobrać napisy do serialu Banshe 3x03, napisy na stronie są, w programie niema, więc muszę odpalić laptopa, pobrać napisy ze strony i przetłoczyć po NFS na HTPC.

kavillock
Posty: 5
Rejestracja: 16 sty 2015, 20:33

Re: API dla programistów programu Napisy24

Post autor: kavillock » 26 sty 2015, 12:22

mam pewien problem, mianowicie napisy znajduję prawidłowo (plik ok), ale dane do napisów już nie. często od innych filmów/ seriali, napisId = 0 więc nie wiem jak wyświetlić link do komentarzy

jako przykład dam: postAction=CheckSub&fs=321308731&ap=myap&fh=1443e97a1a9b5b7e&ua=myua&fn=Once.Upon.a.Time.S03E10.HDTV.x264-LOL.mp4

co do odpowiedzi, chciałem się zapytać od czego jest parametr lp oraz ilea, i czy pierwszy parametr odpowiedzi nie może być typu OK:0, OK:2, wtedy pasuję ideologią do reszty odpowiedzi

jeszcze jak pytam się o angielskie napisy, parametr nl=en jest olewany i i tak znajduję polskie napisy,

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 26 sty 2015, 15:23

parametry lp oraz ilea proszę nie brac pod uwage narazie.
jeżeli napisId=0 oznacza to że napisy zostały dodane do programu poza serwisem, albo w serwisie ale bez hash wtedy takich napisów nie da sie skomentować :-(
W lutym już mam nadzieje odpalić pewne algorytmy które dodadzą do wszystkich napisów w bazie napisy24 odpowiednie hashe do plików - niestety to dość skompikowane i wymaga wielkiej bazy plików którą powoli tworzymy...
w tej chwili parametr jezyka nie jest brany pod uwagę (w bazie praktycznie nie ma angielskich napisów z hash)

kavillock
Posty: 5
Rejestracja: 16 sty 2015, 20:33

Re: API dla programistów programu Napisy24

Post autor: kavillock » 26 sty 2015, 16:27

rozumiem, mam nadzieje że zostanie to naprawione. a czy oczekiwanej zmiany wyszukiwania po nazwie możemy się spodziewać?

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 26 sty 2015, 17:01

tak, ale nie szybko, jestem zawalony robotą, wcześniej dodam wynik w json czy xml, ale wcześniej musze dopracować algorytmy do autohashowania... (a cały czas poprawiam nową stronkę, no i mam swoją pracę też :-))

areq
Posty: 15
Rejestracja: 20 lis 2014, 8:52
Kontakt:

Re: API dla programistów programu Napisy24

Post autor: areq » 01 lut 2015, 0:31

Da sie wyszukiwać po nazwie innym API
viewtopic.php?f=26&t=226

petr
Posty: 3
Rejestracja: 13 lut 2015, 19:48

Re: API dla programistów programu Napisy24

Post autor: petr » 22 lut 2015, 19:03

O co chodzi z tą reklamą pobieraną przez API zamiast napisów?

Jest "OK-2" z zipem z plikiem INFO.txt, a w nim (nazwy serwisu wycięte)

"INFO.txt

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ @
@ ...:::Be...et:::... @
@ @
@ Nie B<EA>dziemy tu was czarowa<E6> po prostu wejdz @
@ @
@ i przekonaj si<EA> sam. @
@ @
@ @
@ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @
@ @
@ ZAPRASZAMY @
@ @
@ @
@ @
@ >>>Be...et<<< @
@ @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
"

Jest tak np dla
OK-2|res:1280x532|time:02:21:42|fps:23.976|imdb:0|ilea:16|ftitle:|fyear:|fgenres:|fwstawil:|ftlumacz:|fkorekta:|fcover:|fimdb:0|napisId:0|lp:240611

Albo przychodzi plik "New Text Document.txt" z wynikiem mediainfo dla pliku.

Ignorować wszystko co przychodzi z napisId == 0? Tylko czemu wtedy dał "OK-2" jakoby miał napisy.

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 22 lut 2015, 20:17

ktoś takie coś wysłał do programu :-(
niestety nie każdy user szanuje innych i robią niektórzy takie ...

tak sie dzieje nieraz przy mniej popularnych releasach - bo system koryguje większość takich "błędów", ale nie da sie automatem wyeliminowac wszystkiego szczególnie dla mniej popularnych plików :-(

Polecam pobierać gdy jest conajmniej podane IMDB, wtedy mamy praktycznie pewność że plik jest sprawdzony przez system.

kavillock
Posty: 5
Rejestracja: 16 sty 2015, 20:33

Re: API dla programistów programu Napisy24

Post autor: kavillock » 23 lut 2015, 19:10

przy n24pref=1 też ten problem występuję? rozumiem że to przez wysyłane napisy przez program? na stronie ich nie ma?

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 23 lut 2015, 21:41

oczywiście że nie ma na stronie takich napisów, program ma swoją bazę dla napsiów których nie ma w serwisie do której każdy może dodać napisy, ale napisy z serwisu powoli zastepują wszystkie napisy z poza serwisu.

kavillock
Posty: 5
Rejestracja: 16 sty 2015, 20:33

Re: API dla programistów programu Napisy24

Post autor: kavillock » 23 lut 2015, 22:14

czyli n24pref=1 rozwiązuję problem?

petr
Posty: 3
Rejestracja: 13 lut 2015, 19:48

Re: API dla programistów programu Napisy24

Post autor: petr » 26 lut 2015, 15:12

Póki co to coś solidnie jest nie tak. Puszczenie POSTa tylko z parametrami [('postAction', 'CheckSub'), ('ua', 'ABC'), ('ap', 'DEF')]
(zamiast ABC, DEF oczywiście podać prawidłowe, bez żadnych innych parametrów)... i dostajemy napisy choć nie powinniśmy:
OK-2|res:|time:|fps:|imdb:0|ilea:0|ftitle:|fyear:|fgenres:|fwstawil:|ftlumacz:|fkorekta:|fcover:|fimdb:0|napisId:79815|lp:352515||...

Dla jakichś filmów PL, z lektorem idzie śmieć (napisy do Glee) mimo n24pref więc to też nie pomaga:
[('postAction', 'CheckSub'), ('ua', 'ABC'), ('ap', 'DEF'), ('n24pref', 1), ('nl', 'pl'), ('fn', 'd00mer-td.2014.pl.s01e05.rerip.720p.hdtv.x264.mkv'), ('fh', '7fb18ce291fe6faa'), ('fs', 1666636161), ('md5', 'ecf7e3b4bad6f2d949261e150ef18e7a')]
OK-2|res:1280x718|time:00:43:26|fps:23.976|imdb:3992234|ilea:7|ftitle:"Glee" Transitioning|fyear:2015|fgenres: Comedy|fwstawil:piterss|ftlumacz:piterss|fkorekta:Nazgul|fcover:http://ia.media-imdb.com/images/M/MV5BM ... lp:2127259||

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 26 lut 2015, 19:36

skąd ludzie pobierają taki plik? bo w bazie nie ma takiego Hash: '7fb18ce291fe6faa' czy MD5 więc nie wiem jak może ci coś podawać...

neo1989
Grupa Hatak
Posty: 42
Rejestracja: 25 paź 2014, 23:01

Re: API dla programistów programu Napisy24

Post autor: neo1989 » 26 lut 2015, 20:53

Takie rzeczy to raczej na PW. :P

Arczi
Administrator
Posty: 706
Rejestracja: 23 paź 2014, 18:37

Re: API dla programistów programu Napisy24

Post autor: Arczi » 02 mar 2015, 10:26

wykryłem jeden poważny problem - hash pliku musiał być dużymi literami, a md5 małymi - poprawiłem, teraz nie ma to znaczenia.

Jeżeli hash był podany małymi literami oczywiście nie dało się znaleźć napisów...

petr
Posty: 3
Rejestracja: 13 lut 2015, 19:48

Re: API dla programistów programu Napisy24

Post autor: petr » 06 mar 2015, 23:23

API niestety jest nadal skopane. Zwraca totalne bzdury w pewnych przypadkach :-(
(szczegóły na PMie)

ODPOWIEDZ
meble kuchenne na wymiar warszawa