updates | dev.cambler.pl

Cambler API

wymaga uwierzytelnienia

POST /updates

Tworzy nowy wpis, rozróżniając wiadomości od statusów po prefiksie ">ktos:"

GET /updates

Zwraca wiadomości uwierzytelnionego użytkownika

GET /updates/50/since

Zwraca wszystkie wiadomości bieżącego użytkownika nowsze od wiadomości o id 50

GET /updates/all

Zwraca wiadomości od wszystkich użytkowników

GET /updates/50/all_since

Zwraca wiadomości od wszystkich użytkowników nowszych od wiadomości o id 50

GET /users/mat/updates

Zwraca wiadomości użytkownika mat

GET /users/mat/updates/3/since

Zwraca wiadomości użytkownika mat nowsze od wiadomości o id 3

GET /updates/5

Zwraca wadomość o id 5

DELETE /updates/5

Kasuje wadomość o id 5

Parametry

?limit=20
Limit zwróconych wiadomości. Domyślnie wynosi maks. 50 wpisów
?offset=20
Parametr offset pozwala cofnąć się w czasie o x statusów

Zasób updates akceptuje następujące parametry przy wykonywaniu zapytania typu POST:

update[body]
Treść tworzonej wadomość, wraz z opcjonalnym prefiksem ">odbiorca:", który sprawia że tworzona jest wadomość kierowana
update[picture]
Obrazek do załączenia

Opis

Pod określeniem update rozumiemy dowolny wpis utworzony w ramach serwisu - zarówno zwykły jak i wiadomość kierowaną do użytkownika. Metody update można używać zamiennie z Status, DirectedMessage i PrivateMessage.

Statusy/wiadomości danego użytkownika znajdują się pod adresem URL: /users/foo/[updates,statuses,directed_messages]
Statusy/wiadomości wszystkich użytkowników znajdują się pod adresem URL: /[updates,statuses,directed_messages]/all

Przykład

http://api.cambler.pl/updates/140


{

   'id': 140,

   'created_at': '2007-10-18 11:27:20',

   'transport': { 'id': 6, 'name': 'www' },

   'transport_description': 'WWW',

   'body': 'witam wszystkich',

   'type': 'Status',

   'user_path': '/users/mat',

   'pictures_path': '/updates/140/pictures',

}

Pola pictures_path, recording_path i movie_path występują tylko wtedy, kiedy do wadomości dołączony jest obrazek, nagranie lub film.