Въведение.

    Това е документацията на официалното API на svejo.net . По-долу ще може да намерите всички методи, чрез които може да получавате информация за публикациите в сайта. Моля, ако смятате че има информация, която би ви била полезна - прегледайте и пишете в дискусиите.

В примерите със син цвят, ще отбелязваме върната информация.

HTTP Заявки.

    Заявките, чрез които може да достъпвате информацията трябва да бъдат HTTP-GET . Това може да направите с всеки браузър, както и с почти всеки програмен език.

Формат на данните.

    Чрез API-то на svejo.net , може да получите желаните данни в 2 формата - XML и JSON. Това, което трябва да направите е да добавите .[FORMAT] в края на URL адреса за заявка, която искате да достигнете. Примерно, за да вземете публикациите, които потребител stanislav е гласувал, може да се обърнете по следния начин - http://svejo.net/public_api/user/stanislav/voted.xml . Съответно ще получите резултат в XML формат. Абсолютно същата заявка, но с резултат в JSON формат , може да бъде направена така: http://svejo.net/public_api/user/stanislav/voted.json

Грешки.

    При възникване на грешка, резултатът ще бъде в заявения от вас формат. Примерно при заявка за XML, може да получите нещо, като това:

<hash>
    <error>No user with this username: foobar</error>
    <request-path>/public_api/user/foobar/published.xml</request-path>
</hash>

Encoding.

    За кодиране на символите се използва - utf-8 . Както за изпращане на заявки, така и за върнатите данни.

Бързи примери.

    Заявка:

http://svejo.net/public_api/stories/fresh.xml

    Отговор:

<records type="array">

    <record>
    <rating type="integer">14</rating>
    <title>
        Българи, македонци и сърби: Винаги сме прави, другите - криви
    </title>
    <url>
        http://svejo.net/home/link_summary/90565-Bulgari-makedonci-i-surbi-Vinagi-sme-pravi-drugite-krivi
    </url>
    <id type="integer">90565</id>
    <comments-num type="integer">0</comments-num>
    <summary>
        Гражданите на Македония, България и Сърбия имат еднакви предразсъдъци, стереотипи и мироглед, показват данните от изследването "Стереотипи в нашия дом и съседите ни"...
    </summary>
    <post-date type="datetime">2008-10-20T10:31:48+03:00</post-date>
    <rating-zeleno type="integer">1</rating-zeleno>
    <fresh>1</fresh>
    <views-count type="integer">22</views-count>
    <image-url-normal>http://svejo.net/img_story_default/9.png</image-url-normal>
    </record>

    ...

</records>

    Заявка:

http://svejo.net/public_api/user/stanislav/voted.xml

Съобщения за бъгове.

    Моля, при грешка свързана с API-то потърсете в дискусиите или пуснете нова тема.

API                                                 

Валидни формати за всички заявки са: xml , json . Върнатите резултати са ограничени до 15.

С оранжев цвят ще отбелязваме динамичните части, които зависят от вашите желания.

Общи заявки:

    URL: http://svejo.net/public_api/stories/fresh.format

  e.g.http://svejo.net/public_api/stories/fresh.json

  Описание: Връща последните публикации от секциятa - Свежи.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

    URL: http://svejo.net/public_api/stories/green.format

  e.g.http://svejo.net/public_api/stories/green.xml

  Описание: Връща последните публикации от секциятa - Нови.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

Потребителски заявки:

    URL: http://svejo.net/public_api/user/username/voted.format 

  e.g.http://svejo.net/public_api/user/stanislav/voted.xml

  Описание: Последните статии, за които е гласувал въпросният потребител.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

    URL: http://svejo.net/public_api/user/username/commented.format 

  e.g.http://svejo.net/public_api/user/stanislav/commented.xml

  Описание: Последните статии, които е гласувал потребителят.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

    URL: http://svejo.net/public_api/user/username/published.format

  e.g.http://svejo.net/public_api/user/stanislav/published.xml

  Описание: Последните статии, които е публикувал потребителят.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

Етикети/Тагове:

    URL: http://svejo.net/public_api/tag/tag_name/new.format

  e.g.http://svejo.net/public_api/tag/София/new.json

  Описание: Най-новите публикации, които имат търсения етикет.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

Сайтове:

    URL: http://svejo.net/public_api/site/domain_name/new.format

  e.g.http://svejo.net/public_api/site/blog.svejo.net/new.xml

  Описание: Най-новите публикации, които имат търсения етикет.

  Атрибути: rating, title, url, id, comments_num, summary, post-date, rating-zeleno, fresh, views-count, image-url-normal

Коментари:

    URL: http://svejo.net/public_api/comments/show/format?url=publication_url

  e.g.http://svejo.net/public_api/comments/show/xml?url=http://advance.bg/?pn=pamporovo

  Описание: Коментарите в svejo.net относно определена публикация. Заедно с тях се връщат потребителите и линкове към техните аватари.

  Атрибути: url-for-avatar, username, url, id, url-for-user, post-date, content