Spis treści

  1. Spis treści
  2. Galerie
    1. Pobieranie info o galerii
    2. Format danych standardowy
    3. Format danych pełny (z full=1)
    4. Edycja info galerii
    5. Usunięcie galerii
    6. Upload fotek do galerii
  3. Fotki
    1. Pobranie info o fotce
    2. Edycja info fotki
    3. Usunięcie fotki
    4. Przeniesienie fotki do innej galerii
    5. Format danych
  4. Lista galerii
    1. Pobranie listy galerii
    2. Format danych
    3. Utworzenie galerii
  5. Limit
    1. Pobranie limitu
    2. Format danych

Galerie

obiekt reprezentujący galerię
URL http://api.grono.net/api/gallery/ID/

Pobieranie info o galerii

pobranie info
metoda GET
parametry format=FORMAT,full=1|0
zwraca name, description, listę URL do fotek
content-type według formatu
statusy 200 OK + content
403 Not Authorized
400 Bad Request
limit 30/minuta
uwagi jeśli do requesta dodamy parametr full o wartości 1, zmienia się struktura<BR>obiektu "photos". Staje się wtedy listą obiektów, które mają pola prawie identyczne jak w obiekcie Photo

Format danych standardowy

({
    "description":"1\r2\r\r4\r\r\r7",
    "title":"mam 2007-07-27T15:48:29.8959 34",
    "photos": [
        "http://api.grono.net/api/photo/29070951/",
        "http://api.grono.net/api/photo/29070874/",
        "http://api.grono.net/api/photo/29070793/",
        "http://api.grono.net/api/photo/29068704/",
        "http://api.grono.net/api/photo/29068680/",
        "http://api.grono.net/api/photo/29068596/",
        "http://api.grono.net/api/photo/29068595/",
        "http://api.grono.net/api/photo/29067481/",
        "http://api.grono.net/api/photo/29067480/",
        "http://api.grono.net/api/photo/29067334/",
        "http://api.grono.net/api/photo/29067325/",
        "http://api.grono.net/api/photo/28834126/",
        "http://api.grono.net/api/photo/28833973/",
        "http://api.grono.net/api/photo/28833901/",
        "http://api.grono.net/api/photo/27393528/",
        "http://api.grono.net/api/photo/23017733/",
        "http://api.grono.net/api/photo/16973898/",
        "http://api.grono.net/api/photo/16618101/"],
    "thumbnail_url": "http://b62.grono.net/88/95/gallery-16618101-100x100.jpg",
    "owner_id":699687
})

Format danych pełny (z full=1)

<Gallery xmlns="http://api.grono.net/schema">
    <description>asdas</description>
        <title>divas8</title>
        <photos>
            <item>
                <map_lat /><map_lng /><map_zl /><map_alt />
                <description />
                <title>Candice-Michelle-0042.jpg</title>
                <orig_url>http://b12.grono.net/27/110/gallery-33040327.jpg</orig_url>                
                <thumbnail_url>http://b62.grono.net/102/223/gallery-33040327-100x100.jpg</thumbnail_url>
                <image_url>http://b62.grono.net/171/181/gallery-33040327-500x500.jpg</image_url>
                <owner>http://api.grono.net/api/profile/699687/</owner>
            </item>
        </photos>
    <thumbnail_url>http://b12.grono.net/239/77/gallery-33040323-100x100.jpg</thumbnail_url>
    <id>4005366</id>
    <owner_id>699687</owner_id>
</Gallery>

Edycja info galerii

edycja info
metoda POST (PUT)
parametry format=FORMAT
title=NAZWA
description=OPIS
zwraca 204 No Content
403 Not Authorized
400 Bad Request
limit 15/minuta

Usunięcie galerii

usunięcie
metoda POST (DELETE)
parametry delete=1
zwraca 204 No Content
403 Not Authorized
400 Bad Request
limit 15/minuta

Upload fotek do galerii

URL http://api.grono.net/api/gallery/ID/upload/
metoda POST
dane name=NAZWA,description=OPIS,data=OBRAZEK
content-type multipart/form-data
zwraca 201 Created, w headerze Location URL nowej fotki
403 Not Authorized
400 Bad Request
409 Conflict
limit 1000/godzina
uwagi nie obsługuje innych formatów niż HTTP POST

Fotki

obiekt reprezentujący fotkę
URL http://api.grono.net/api/photo/ID/

Pobranie info o fotce

metoda GET
parametry format=FORMAT
zwraca 200 OK + content
403 Not Authorized
400 Bad Request
limit 30/minuta

Edycja info fotki

edycja info
metoda POST
parametry format=FORMAT
dane name=NAZWA
description=OPIS
zwraca 204 No Content
403 Not Authorized
400 Bad Request
limit 15/minuta

Usunięcie fotki

metoda POST (DELETE)
parametry delete=1
zwraca 204 No Content
403 Forbidden
400 Bad Request
limit 15/minuta

Przeniesienie fotki do innej galerii

URL http://api.grono.net/api/photo/ID/move/
metoda POST
parametry dest=URL docelowej galeri
zwraca 204 No Content
400 Bad Request
404 Not Found

Dostępne od: 15 kwietnia 2008. Uwaga: URL docelowej galerii oznacza, że nie wkładamy tu numerycznego ID galerii, a cały URL jakim się do niej odwołujemy, czyli ten stąd.

Format danych

({
   "title": "abcdefg",
   "description": "lorem ipsum dolor sit amet",
   "thumbnail_url": "http://b62.grono.net/88/95/gallery-16618101-100x100.jpg",
   "image_url": "http://b62.grono.net/23/192/gallery-16618101-500x500.jpg",
   "orig_url": "http://b62.grono.net/79/45/gallery-16618101.jpg",
   "owner_id": 699687,
   "exif_camera": ""
})

Jeśli fotka ma dane geograficzne, dochodzą kolejne pola: 

   "map_lat": 54.123124,
   "map_lng": 18.435345,
   "map_zl": 13,
   "map_alt": 0,

Lista galerii

obiekt reprezentujący listę galerii użytkownika
URL http://api.grono.net/api/galleries/USER_ID_LUB_LOGIN/

Pobranie listy galerii

metoda GET
parametry format=FORMAT
zwraca 200 OK + dane
403 Forbidden
404 Not Found
limity 120/godzina

Format danych

({
    "gallery_list": [
        {"url":"http://api.grono.net/api/gallery/3793291/", "thumbnail_url":"/s/style/common/no_photo.gif", "photos_number": 0},
        {"url":"http://api.grono.net/api/gallery/3793269/","thumbnail_url":"/s/style/common/no_photo.gif", "photos_number": 0},
        {"url":"http://api.grono.net/api/gallery/3793266/","thumbnail_url":"/s/style/common/no_photo.gif", "photos_number": 0},
        {"url":"http://api.grono.net/api/gallery/3653742/","thumbnail_url":"http://b88.grono.net/53/206/gallery-29068682-100x100.jpg", "photos_number": 4},
        {"url":"http://api.grono.net/api/gallery/2371677/","thumbnail_url":"http://b62.grono.net/88/95/gallery-16618101-100x100.jpg", "photos_number": 5},
        {"url":"http://api.grono.net/api/gallery/2371671/","thumbnail_url":"http://b62.grono.net/207/201/gallery-16619228-100x100.jpg", "photos_number": 12},
        {"url":"http://api.grono.net/api/gallery/2291076/","thumbnail_url":"http://b0.grono.net/169/40/gallery-16090632-100x100.jpg", "photos_number": 6},
        {"url":"http://api.grono.net/api/gallery/2200915/","thumbnail_url":"http://b12.grono.net/70/20/gallery-16617882-100x100.jpg", "photos_number": 10},
        {"url":"http://api.grono.net/api/gallery/2200910/","thumbnail_url":"/s/style/common/no_photo.gif", "photos_number": 0},
        {"url":"http://api.grono.net/api/gallery/1994879/","thumbnail_url":"http://b62.grono.net/152/198/gallery-13968075-100x100.jpg", "photos_number": 3},
        {"url":"http://api.grono.net/api/gallery/1887586/","thumbnail_url":"/s/style/common/no_photo.gif", "photos_number": 0},
        {"url":"http://api.grono.net/api/gallery/1873119/","thumbnail_url":"http://b33.grono.net/58/70/gallery-13186501-100x100.jpg", "photos_number": 4},
        {"url":"http://api.grono.net/api/gallery/1006026/","thumbnail_url":"http://b0.grono.net/69/129/gallery-7966637-100x100.jpg", "photos_number": 4}
    ]
})

Utworzenie galerii

metoda POST
parametry in_format=FORMAT
dane title=NAZWA
description=OPIS
zwraca 201 Created, w headerze Location URL nowej galerii
403 Forbidden
400 Bad Request
409 Conflict
limity 30/godzina

Limit

obiekt reprezentujący limit transferu użytkownika
URL http://api.grono.net/api/uploadlimit/USER_ID_LUB_LOGIN/

Pobranie limitu

metoda GET
parametry format=FORMAT
zwraca 200 OK + dane
403 Forbidden
404 Not Found
limity 12/godzina

Format danych

<?xml version="1.0" encoding="utf-8"?>
<UploadLimit xmlns="http://api.grono.net/schema">
    <used>3077941</used>
    <limit>209715200</limit>
</UploadLimit>