We're very happy to announce the availability of SOAP API's for SermonAudio.com. Web API's (or web services) allow programmers to access and interact with data on the site using any client front-end and on any platform. SOAP (Simple Object Access Protocol) is a standard protocol for exchanging XML-based messages over HTTP.
Are you a web design company? Here's a tip. Developing an integrated solution with SermonAudio via the SOAP API provides a strong value-add for your web church clients. Your clients can enjoy all of the additional exposure on SermonAudio while still having their sermons tightly integrated into the design of their own standalone website.
Who is this for? Programmers and web developers. Opening up SermonAudio via SOAP API's will allow programmers and web developers to extend the rich functionality of SermonAudio beyond the confines of the browser. Client applications can now access data on SermonAudio with dynamic, interactive controls. Web components can integrate SermonAudio sermons on to any third-party website with your own look-and-feel.
To access the SermonAudio SOAP API's, please refer to the following reference URL:
GetEventTypes - Returns a list of valid event categories.
GetLanguages - Returns a list of valid languages.
GetSeriesByMemberID - Returns all sermon series by Member ID.
GetSpeakersByKeyword - Returns all speakers by matching keywords.
GetSpeakersByMemberID - Returns all speakers by Member ID.
NewestSermonsByMemberID - Returns newest sermons by Member ID.
NewestSermonsBySpeaker - Returns newest sermons by speaker.
New! GetSermonInfo - Returns the details of a single sermon by Sermon ID.
New! UpdateSermon - Updates the details of a single sermon by Sermon ID.
SermonList - Returns all sermons (title, speaker, etc) by Member ID. Optional Category: "speaker", "eventtype", "series", "year" Optional Item: Value for corresponding category.
SubmitSermon - Submits a sermon entry and returns the Sermon ID. All date fields are in the format: YYYY-MM-DD.
Please note. The 10-FREE policy is unavailable with the SubmitSermon method. There is a standard $1 charge for every sermon submitted via this API. But for those churches needing to submit a backlog of sermons in batch, we hope this will provide that extra flexibility and convenience.
So for example, using the SubmitSermon API, a program could be written to submit multiple sermon entries to SermonAudio (in batch). Or using the SermonList API, a program could be written to retrieve the complete sermon listing for your church, and slice, dice, and search the data quickly in a client-side application.
The possibilities are endless!
Over time, we will continue to expand the API's available for programmers to best fit your needs. Feel free to email us with feedback or suggestions for improvement.
Interactive Sermon Browser! And remember, even if you are not a web developer or programmer, you can still enjoy putting all of your sermons on your own website with a single line of copy-and-paste HTML code using our interactive sermon browser..
Flash Widget For Your Own Site! In addition, an entirely new flash widget is now available which allows you to display and play the newest sermons, videos, or picks from any broadcaster account on your own website! Click here to learn more..
Batch upload utility for Drupal written by one of our broadcasters. Joe Wheaton or Lancaster Baptist Church has written the following comment:
I created a module for the Drupal CMS that allows users to mass import their sermons into SermonAudio. It might be helpful for any prospective broadcasters to know that they will be able to mass import their sermons from Drupal into SermonAudio without much hassle.
Automated upload utility for Linux written by one of our broadcasters. Scott McMahan or Radio Missions has written the following comment (more below):
If you see Old Trailblazer episodes on Revelation by Pastor Albert Pendarvis in 2009, these are uploaded in a totally automated process using the SOAP API. Each morning at 7am, a job scheduler (cron) runs my SOAP client (see link in previous comment). The software has a list of which files to upload on which day, and performs the upload automatically.
If you have a radio broadcast, a sermon archive, or some other periodic daily or weekly audio you want to upload, this could help you set it up ahead of time and let it run automatically.
On a limited basis, I might be able to do this for you along as I am doing the Old Trailblazer uploads.
If you see Old Trailblazer episodes on Revelation by Pastor Albert Pendarvis in 2009, these are uploaded in a totally automated process using the SOAP API. Each morning at 7am, a job scheduler (cron) runs my SOAP client (see link in previous comment). The software has a list of which files to upload on which day, and performs the upload automatically.
If you have a radio broadcast, a sermon archive, or some other periodic daily or weekly audio you want to upload, this could help you set it up ahead of time and let it run automatically.
On a limited basis, I might be able to do this for you along as I am doing the Old Trailblazer uploads.
If you want to see a sample of this powerful web services API in action, I have written a sample batch sermon upload program. You can check it out in my blog on this site or go to www.scottmcmahan.net/sermonupload -- the code is free software, under the GPL license.
1
There are a total of 2 user comments displayed | add new comment |
COMMENTS | 
4/1/09 6:14 AM
