Spis treści

  1. Spis treści
  2. Grono tematyczne
    1. Pobranie info
    2. Format danych
    3. Edycja info
  3. Forum
    1. Pobranie info
    2. Format danych
    3. Założenie nowego tematu
  4. Topic
    1. Pobranie info
    2. Format danych
    3. Napisanie posta w wątku
  5. Obserwowane wątki
    1. Pobranie info
    2. Format danych

Grono tematyczne

obiekt reprezentujący grono tematyczne
URL http://api.grono.net/api/pubcomm/PUBCOMM_ID/

Pobranie info

metoda GET
zwraca 200 OK + info
404 Not Found
403 Forbidden
parametry format=FORMAT
uwagi 404 jeśli grono prywatne, a użytkownik do niego nie należy

Format danych

<Pubcomm>
  <forum_url>http://api.grono.net/api/forum/83660/</forum_url>
  <description>Witamy,

Administracja komunikuje się z Beta-Testerami za pomocą tego grona tematycznego, które służy do przekazywania informacji, wytycznych itd.

Pozdrawiamy serdecznie,
Zespół Grono.net
  </description>
  <private>True</private>
  <members>129</members>
  <owner_id>393673</owner_id>
  <name>BETA TESTY</name>
</Pubcomm>

Edycja info

metoda PUT
zwraca 204 No Content
404 Not Found
403 Forbidden
parametry in_format=FORMAT
dane name=NAZWA,description=OPIS
uwagi edycja tylko dla moderatorów i właściciela

Forum

obiekt reprezentujący forum
URL http://api.grono.net/api/forum/FORUM_ID/

Pobranie info

metoda GET
zwraca 200 OK + info
404 Not Found
403 Forbidden
parametry format=FORMAT
uwagi 404 jeśli forum przypisane do grona prywatnego, a użytkownik do niego nie należy

Format danych

<Forum>
  <latest_topic_list>
    <item>
      <lastpost>
        <scrname>Tommy™</scrname>
        <id>114062</id>
        <time>dzisiaj 13:34</time>
      </lastpost>
      <closed>False</closed>
      <created>
        <scrname>Patiks</scrname>
        <id>499695</id>
        <time>30/07/2007 18:00</time>
      </created>
      <url>http://api.grono.net/api/topic/3526826/</url>
      <subject>Komunikator Gronowy - TUTAJ BŁĘDY&#33;</subject>
      <sticky>True</sticky>
    </item>
  </latest_topic_list>
  <attachment_list>
    <item>
      <orig_url>http://b0.grono.net/58/41/gallery-29341513-500x500.jpg</orig_url>
      <thumbnail_url>http://b88.grono.net/51/145/gallery-29341513-100x100.jpg</thumbnail_url>
    </item>
  </attachment_list>
</Forum>

Attachment-list jest tylko pierwszą stroną (najnowszych 20 elementów).

Założenie nowego tematu

metoda POST
parametry format=FORMAT
dane subject=TEMAT, body=TREŚĆ
zwraca 201 Created + URL do nowego topiku (w Location:)
403 Forbidden
404 Not Found

Topic

obiekt reprezentujący temat
URL http://api.grono.net/api/topic/TOPIC_ID/

Pobranie info

metoda GET
parametry format=FORMAT
zwraca 200 OK + lista
403 Forbidden
404 Not Found

Format danych

Uwaga: niezależnie od formatu (tutaj GronoXML), treść posta będzie zawierać <br/>. 

<Topic>
  <latest_post_list>
    <item>
      <body>
<br />
Zapraszam do testowania i zgłaszania błędów.
<br />

<br />
Obsługa banalna: Enter wysyła blimpa, Esc anuluje edycję. Pod prawym klawiszem jest wyjście i konfiguracja.
<br />
Chmurkę można przesuwać łapiąc ją myszką poza polem edycji.
<br />

<br />
Pozdrawiam
<br />
      </body>
      <scrname>the A</scrname>
      <avatar_url>http://b12.grono.net/111/100/avatar-100908.gif</avatar_url>
      <added>03/08/2007 10:42</added>
    </item>
  </latest_poll_list>
  <attachment_list>
    <item>
      <orig_url>http://b62.grono.net/42/57/gallery-25501350-500x500.jpg</orig_url>
      <thumbnail_url>http://b12.grono.net/103/170/gallery-25501350-100x100.jpg</thumbnail_url>
    </item>
  </attachment_list>
</Topic>

Uwaga: attachment-list ma takie same właściwości jak dla forum.

Napisanie posta w wątku

metoda POST
parametry in_format=FORMAT
dane body=TREŚĆ
zwraca 201 Created
403 Forbidden
404 Not Found

Obserwowane wątki

obiekt reprezentujący listę obserwowanych tematów
URL http://api.grono.net/api/starredtopics/USER_ID_LUB_LOGIN/

Pobranie info

metoda GET
zwraca 200 OK + info
404 Not Found
403 Forbidden
parametry format=FORMAT
limit 5 na 10 minut

Format danych

<StarredTopics>
  <topic_list>
    <item>
      <lastpost><scrname>&#7433;u&#633;&#441;&#670;</scrname><id>699687</id><time>2007-11-07 17:05:54.246090</time></lastpost>
      <closed>False</closed>
      <created><scrname>Keep ya head up&amp;#33;</scrname><id>106875</id><time>2007-10-27 18:46:11.527500</time></created>
      <url>http://api.grono.net/api/topic/5938834/</url>
      <subject>Dost&#281;pne Platformy</subject>
      <sticky>False</sticky>
    </item>
    [...]
  </topic_list>
</StarredTopics>