Bums.se - API

Inledning

Bums.se tillhandahåller ett SOAP-api som kan användas för att hämta och posta information till tjänsten. Nedan följer en kort sammanfattning av vilka metoder som tillhandahålls, och hur de fungerar, men du som utvecklare förväntas innan du läser denna text ha en grundläggande uppfattning av hur SOAP fungerar och hur det används.

Användare och autenticering

En komplett lista med metoder finns tillgänglig på följande url:
http://bums.se/api/webservices/userservice.asmx

Autenticiera användare

Url till metod:
http://bums.se/api/webservices/userservice.asmx?op=SignIn

För att kunna använda de flesta andra metoder i API:et behöver man autenticiera en användare. Metoden returnerar en sträng innehållande en nyckel, som sedan används i övriga metoder som parameter för att tillhandahålla / posta data.

Användarens galleri

En komplett lista med metoder finns tillgänglig på följande url:
http://bums.se/api/webservices/galleryservice.asmx

Skapa album

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=CreateAlbum

Skapa ett album för den nyligen inloggade användaren.

Hämta album

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=GetAlbums

Hämta användarens album.

Hämta bilder

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=GetImages

Hämta en lista med metadata för bilder i ett album (albumets Id ska skickas med som parameter till metoden).

Hämta url till en enskild bild

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=GetImageUrl

Denna metod genererar en länk till en bild, utefter bildens Id samt vilka storleksparametrar som skickas med.

Hämta bilder (optimerad)

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=GetImagesWithUrls

Denna metod är optimerad så att man ska slippa göra anrop för att hämta url till varje enskild bild i ett album (om man i förväg vet vilka storleksparametrar man vill använda). Metoden returnerar en url till en tumnagelbild som är kvadratiskt omskalad, samt en url till en normalt omskalad bild.

Hämta bilder (optimerad, icke kvadratiskt omskalad)

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=GetImagesWithUrlsNonCroppedThumbnail

Denna metod gör samma sak som ovanstående, men tumnagelbilden är inte kvadratiskt omskalad.

Posta bild

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=PostImage

Denna metod gör samma sak som ovanstående, men tumnagelbilden är inte kvadratiskt omskalad.

Posta bild med metadata

Url till metod:
http://bums.se/api/webservices/galleryservice.asmx?op=PostImageWithMetaData

Sparar en bild på bums.se på samma sätt som ovan, dock ger denna metod dig möjlighet att sätta en del av meta-informationen själv.

Händelser

En komplett lista med metoder finns tillgänglig på följande url:
http://bums.se/api/webservices/notificationservice.asmx

Hämta händelser

Url till metod:
http://bums.se/api/webservices/notificationservice.asmx?op=GetNotifications

Hämtar en användares händelser.

Hämta antal olästa händelser

Url till metod:
http://bums.se/api/webservices/notificationservice.asmx?op=GetUnreadCount

Hämtar det antal händelser som inträffat sedan användaren senast såg listan med notifieringar.

Markera som läst

Url till metod:
http://bums.se/api/webservices/notificationservice.asmx?op=SetNotificationsRead

Markerar att användaren har sett notifieringslistan, så nästa gång man hämtar antal olästa händelser kommer metoden utgå ifrån att användaren har sett de notifieringar som är äldre än det datum som denna metod anropas.

Publika RSS feeds

Nedan följer en lista med de publika RSS-feeds som kan användas för att hämta bilder ifrån bums.

Har du också bilder du vill visa?

Börja ladda upp