API

[zenprzy]

Czy z blox.pl mozna/bedzie mozna komunikowac sie za pomoca jakiegos interfejsu
API typu Atom czy XML-RPC?

[mpieck]

Bloxer używa XML-RPC do komunikacji z blox.pl, specyfikacja nie jest co prawda
udostępniona, ale jeżeli ktoś chce napisać ciekawy pragram/usługę do bloxa i
podzielić się tym z użytkownikami to generalnie nie widzę przeszkód, żeby mu tą
specyfikację udostępnić.

[jzgoda]

A do kogo się zgłosić, żeby taki spec otrzymać?

[mpieck]

Przepraszam, ale obecnie nie mam czasu żeby ją spisać.

[worldpl]

Piszę żeby podbić ten temat wyżej. No i co z problemem? Czy ktoś mógłby się tym
zająć? Może podesłać specyfikację autorowi rozszerzenia JustBlogIt?
blog.warmbrain.com/justblogit/

[mpieck]

Wysłałem instrukcję obsługi API do wszystkich osób z tego wątku na konta w
gazeta.pl

ja też poproszę

[leniuch102]

[mpieck]

Doszedłem do wniosku, że lepiej będzie jak zaraz to spiszę i opublikuję.

Adres dokumentacji API

[mpieck]

blox.pl/html?page=apiBlox, również do przejrzenia dla 4 osób, którym wysłałem API wcześniej mailem, bo tam nie podałem całości.

[jzgoda]

Nie wszystko jest całkiem jasne. Na przykład na stronie, którą podałeś, w
sygnaturze metody newPost jest "blogid nazwa bloga, do którego będzie wysłana
nowa notka, np. dla bloga o adresie xyz.blox.pl będzie to xyz", a tymczasem w
opisie, który nam wysłałeś mailem jest "blogid Unique identifier of the blog the
post will be added to". Nie próbowałem podawać nazwy, ale z identyfikatorem (np.
z getUsersBlogs) działa bezbłędnie. Wolałbym używać identyfikatora, bo metoda
getUsersBlogs daje mi cały mechanizm do "weblog discovery"...

[mpieck]

A to moja wina, bo nie poprawiłem dokumentacji. Ostatnio zmieniałem API, żeby
było zgodne ze specyfikacjami bloggera i metaWeblog, bo były problemy z
Performancing for FF. Między innymi zmieniłem interpretację blogId, ale zmiana
jest kompatybilna wstecz. W tej chwili jako blogId można podać nazwę bloga lub
jego identyfikator liczbowy pobrany metodą getUserBlogs. Najpierw jest
sprawdzane to pierwsze, jeżeli jest ok. to idzie dalej, jeżeli nie to sprawdza
na drugi sposób. Preferowane jest podawanie liczbowego identyfikatora, bo jest
to zgodne ze specyfikacją. Niestety API było pisane pod Bloxera, a Bloxer
podaje nazwę a nie liczbę, podejrzewam że tak było łatwiej napisać program, bo
nie trzeba pobierać listy blogów z identyfikatorami. Jeżeli zmienimy Bloxera to
wyrzucę z API przyjmowanie nazwy bloga, żeby nie mieszało.

[jzgoda]

O, czyli API jest żywe? Fajnie, może pojawi się możliwość ustawiania kategorii
wpisu?

[mpieck]

> O, czyli API jest żywe?

W granicach rozsądku i zgodności ze specyfikacjami. W chwili gdy przesyłałem
wam opis API, nie wszystko działało tak jak powinno lub jak myślałem, że działa
(nie ja to pisałem).

> Fajnie, może pojawi się możliwość ustawiania kategorii
> wpisu?

W metaWeblog API jest taka możliwość, u nas można ustawić 1 kategorię.

[jzgoda]

Następne pytanie, tym razem dot. maksymalnych rozmiarów przesyłanych danych w
obu dostępnych API. Cytat:
<string> "title" - tytuł notki (max 255 znaków)
<string> "description" - treść notki (max 16KB)
To jest z opisu MetaWeblog, w opisie Blogger API nie ma słowa na temat limitów,
ale one istnieją... I są o wiele mniejsze (np. tytuł poniżej 160 znaków). Taka
informacja też byłaby chyba przydatna. I jeszcze, czy w przypadku przesłania
większej ilości danych zostaną one obcięte, czy zostanie zwrócony błąd (przy
wysyłaniu przez blogger.newPost() dane są obcinane).
Poza tym, można by to ujednolicić? Albo w obu zacytowanych wyżej przypadkach
nałożyć ograniczenie na rozmiar w bajtach, albo w znakach (tak byłoby chyba
lepiej, bo przecież i tak po drucie leci UTF-8).

[mpieck]

dla obydwu API limity są takie same, jeżeli string jest zadługi to jest
obcinany i nie ma w takim przypadku komunikatu o błędzie.

[jzgoda]

A gdzie można zgłaszać błędy? Bo właśnie na serwerze wyskoczyłe NPE i dostałem
Fault 0...

[mpieck]

jzgoda napisał:

> A gdzie można zgłaszać błędy? Bo właśnie na serwerze wyskoczyłe NPE i dostałem
> Fault 0...

tego typu najlepiej na [e-mail]