Revive Adserver: RESTful API Wrapper

Finally, our development team at Black River got a chance to try out the new Revive Adserver (formerly OpenX Source) RESTful API Wrapper made by openxsourcerestapi.com.

The API wrapper comes in a form of an extremely clean and tight package – all you have to do is unzip it into the www/api/ folder of your Revive Adserver installation, where it will reside alongside the v1 and v2 versions of the default legacy XML-RPC wrapper.

Code wise, the whole package looks very clean, professional and well organised – I only wish there was a bit more commentary inside the actual sources, just in case anything has to be modified or slightly tailored for clients’ specific applications.

The package comes with a sample PHP client and examples of all possible REST calls included in the API. It makes the initial implementation a breeze – you never have to guess which parameters and what format you have to use in the API calls (unlike the default XML-RPC wrapper).

We have integrated this wrapper into some of our current Revive Adserver project to get a better idea of the overall performance under load. We were pleasantly surprised to see that many of the calls clearly produced a performance improvement over the stock API.

Another very important aspect that I must mention is the complete API documentation available on the openxsourcerestapi.com site, there you can find the definition of all possible calls included into the wrapper, the required argument types and return values. This is probably the key downside of the stock Revive Adserver XML-RPC API implementation – absolute lack of documentation and the ever so diminishing support.

So, if you or your company is already developing any kind of 3rd party software that has to communicate with Revive Adserver via API calls, or you are just starting out and learning the trade – this wrapper is definitely a must-have! You will save many hours of frustration and aggravation  trying to get the stock API to work. When it comes to Revive Adserver related products, this is the best money we have ever spent!

7 Responses to “Revive Adserver: RESTful API Wrapper”

  1. They re charging for API!!!!

    1. They are charging for a well organised and neatly documented RESTful wrapper – a must have if you are doing any serious OpenX API work.

  2. Terry June 4, 2014

    Would this work with Revive?

    1. Ilya Ber June 4, 2014

      Yes, it would.

  3. WOW, i think its a free API, but… arrggghh TT

  4. hi, nice info, but it’s a paid api, is there any free revive adserver api out there?

    1. Ilya Ber March 16, 2015

      Revive still has the built-in XML-RPC API inherited from OpenX Source, please review the other blog posts.

Comments are closed. Questions? Get in touch.