• sourberry API, HTTP üzerinden servisler sunar.
• Cevaplar REST şeklindedir.
• Bilgi okur servisler GET, okur-yazar servisler POST ya da PUT, silen servisler DELETE ile çağrılmalıdır.
• PUT ve DELETE için, X-HTTP-Method-Override ile yapılan HTTP POST istekleri desteklenmektedir. (ör. X-HTTP-Method-Override: DELETE)
• POST, PUT ve DELETE için, _method parametresiyle yapılan HTTP GET istekleri desteklenmektedir. (ör: http://adres?_method=POST)
• Varsayılan cevap formatı XML'dir. format=json parametresi ya da Accept: application/json header ibaresi ile JSON formatında cevap alınabilir.
• Encoding UTF-8'dir.
• API noktası http://api.sourberry.org/ adresindedir.
• Kullanım {API noktası}{servis} şeklinde gerçekleşir.

Şu an için sınırlı sayıda servis desteklenmektedir. * işaretli olanlara access token göndererek login olabilirsiniz. Access token, access_token REST parametresi kullanılarak gönderilmelidir.

• Servis adı: status
  Açıklama: sourberry'deki yayın durumunu verir.
  GET Parametreleri: flags opsiyonel, bit-field (1:dinleyici listesini, 2:son çalanları, 4:çok çalanları dahil et)
  Örnek XML kullanım: http://api.sourberry.org/status
  Örnek JSON kullanım: http://api.sourberry.org/status?format=json
  
• Servis adı: schedule
  Açıklama: sourberry günlük yayın akışını verir.
  GET Parametreleri: day opsiyonel, gün no (1=pazartesi, 7=pazar)
  Örnek XML kullanım: http://api.sourberry.org/schedule
  Örnek JSON kullanım: http://api.sourberry.org/schedule?format=json
  
• Servis adı: info (*)
  Açıklama: mevcut kullanıcı bilgilerini (isim, avatar, gibi) verir.
  Örnek XML kullanım: http://api.sourberry.org/info
  Örnek JSON kullanım: http://api.sourberry.org/info?format=json
  
• Servis adı: shouts (*)
  Açıklama: shoutberry içeriğini verir. HTTP POST ile çağrıldığında, "message" parametresindeki mesajı shoutberry'e gönderir.
  Örnek XML kullanım: http://api.sourberry.org/shouts
  Örnek JSON kullanım: http://api.sourberry.org/shouts?format=json
  
• Servis adı: takip (*)
  Açıklama: Access token ile çağrılır. Takip edilen program ve djlerin listesini verir.
  HTTP POST ile çağrıldığında, program_id, dj_id ve method parametrelerini alır, id'si verilen program ya da dj'i ilgili method ile takibe alır.
  HTTP DELETE ile çağrıldığında id parametresi ile verilen takip kaydını siler.
  
  Takip için kullanılabilecek methodlar liste çıktısında validMethods ile listelenir, her kullanıcı için farklılık gösterebilir.