Boomi Cloud API Management Developer Blog

As your own API initiatives have grown and your needs to either extend your Mashery Developer Portal or integrate with your other systems have increased, we found a need to expand our own API to cover your requirements.  As such, we are pleased to announce the release of version 2.0 of the Mashery API!

Version 2.0 is more comprehensive compared to its predecessor in its coverage of Mashery objects.  It also includes a powerful query language, allowing you to easily perform ad hoc queries for objects. The following objects are supported:

1. Members
2. Applications
3. Keys
4. Roles
5. Service Definitions (including cache)

With this release, we have also created a sandbox site for you to use to safely build and test your programs before deploying them to production.

To get started, peruse our comprehensive documentation.  Then, login to this site with the administrative account that you want to own your API keys.  Request new API keys to gain access by registering on our key registration pages.  Note, data access rights are governed by the rights of the account that owns the API key used so consider which accounts you want to have keys. 

Happy New Year everyone!

We're pleased to announce the release of our new Roles based access control capabilities in the Developer Portal! 

It has been interesting to be part of our customers' API programs as they continue to grow and mature.  One clear trend we've seen is that many APIs eventually have both external and internal benefit.  Some customers start with opening external access for app development as the goal and find unexpected valuable internal uses.  For example, we saw a large customer find a sister site had been screen scraping their content, but started using the API as a better way to integrate (rightly so).  They noticed and added a few private data elements for them and drove significant savings in the end.  

Another interesting set of use cases has been private beta programs.  Many times this has been the usual early development phase for a new program.  However, increasingly, we see mature programs extending their API and want to expose their new version or methods to a limited set of beta developers.  Makes total sense. 

One of the features that emerges in each situation is a need to control which content pages users have access to.  You want your new beta only methods to be viewable to beta partners, but nobody else to reduce confusion.  Or you want to have internal documentation pages for your colleagues.  But when you run large communities of developer partners, you need something like Roles to manage the complexity.  This feature will help.

With this release, you will have the ability to create Roles, grant them content access rights, and then group your users into them.  Additionally, we've packaged up a set of Mashery Dashboard Roles that govern which administrative Dashboard tabs your admins have access to.

Here's an example of using Roles for page access control.

Step 1: Create a Role

Step 2: Assign Users to Role

Step 3: Assign content pages to Roles to restrict access

Done!  Now only users within the assigned "Internal Acme" Role will see the page.  The navigation aids and search features of course also adhere to the access rights granted via Roles. 

For the Dashboard Roles that we now support (e.g. Content Manager), we think you'll understand the Role name and the tabs that they have access to pretty quickly. However, if you click into each on the Roles tab in the Dashboard, you'll find a description and what functionality they grant access to.

As always, please let us know what you think!

Wow, it was a busy summer.  We have been adding lots of great new customers and for you old timers, we see really healthy volume growth through a large section of the APIs we service.  We've been bursting through volume records every month!  It's great to see and be part of your success.  

I haven't posted a blog entry for some time, so thought I'd mention a small but nice feature add that was released last night for those customers that use Mashery caching services.  In the past, we fully managed your cache.  If for some reason, you needed to flush your cache, we were happy to provide you this support.  However, immediate self-serve capability was necessary since sometimes, you just need to move faster than we can offer through our support function. Now you can!

Your API administrators may navigate to the API Settings tab in the Dashboard and find the new "Cache" tab.  There's a simple flush button that takes affect within 8 mins. Give it a try and let us have your feedback!

We are pleased to announce a major upgrade to the Developer Management capabilities of the Mashery Developer Portal.  The improvements provide a rich set of new options for how we register your developers, grant them keys and register the applications they build.  Additionally, the User Administration Dashboard has been completely redesigned for usability and improved visibility into your developer community. 

This has been a significant product development undertaking and we'd like to thank all of our great customers that have provided feedback or performed design reviews along the way.  We'd love even more feedback now that you can touch and feel the new functionality, so as usual, post to the forums, send an email to support@mashery.com, or tell your Client Service Manager the good, bad, and (hopefully not) ugly! 

For more information on what was included in this release, please read through the release notes (you must be logged on).

Mashery Clients,

Please be advised that we will have a partial service outage for maintenance purposes this Saturday, July 11th, from 8:00pm to Sunday 2:00am Eastern Daylight Time (EDT).  We will be releasing significant upgrades to the Developer Management aspects of your developer portal.  During this period, the following services will be unavailable:

   1. Developer Portals
   2. Mashery API

Please note, the Mashery API Proxy Service will continue to operate normally and no developer calls to your API will be impacted.  Please contact support@mashery.com with any questions.  During the maintenance window, you may follow our progress with @MasheryOps on Twitter.

More information will be forthcoming about the exciting features that will be released over the weekend.

Thank you,

The Mashery Product Team

We’re pleased to announce the release of a new feature of our API Management service, Bulk Calls.  

Do you have developers on mobile or hardware devices such as set-top boxes or game consoles? Many times, these devices are limited by the number of outbound HTTP requests they can make.   Or do you perhaps just have developers with sites that run in network challenged environments?  We built the Bulk Calls feature just for you.  

Depending on your API, you might be able to help your developers build more responsive applications by allowing many API calls to be sent inside a single wrapper call.  Our Bulk Call feature allows this.  And best yet, you don’t need to make a change to your API!  This all works within the Mashery Service via configuration with our team.

Interested?  Call your Client Services Manager or send us an email to support@mashery.com.

Mashery Clients,

Please be advised that we will have a partial service outage for maintenance purposes this Sunday from 9:00am-10:00am Pacific Daylight Time (PDT).  During this period, the following services will be unavailable:

1. Client Developer Portals
2. Mashery API

Please note, the Mashery API Proxy Service will continue to operate normally and no developer calls to your API will be impacted.  Please contact support@mashery.com with any questions.  During the maintenance window, you may follow our progress with @MasheryOps on Twitter.

Thank you.

UPDATE: ISSUE RESOLVED AS OF 2:00pm PDT

+++

Mashery Clients,

Please be advised the we are having problems with our reporting feature.  All Dashboard->Reports pages are non responsive due to a hardware issue.  We believe we are close to resolution and are currently projecting availability by 1pm PDT.

For more up to date information, you may follow the operations team on Twitter with @MasheryOps.

We apologize for the inconvenience.

Best Regards,
Mashery Support

Mashery Standard Network Clients,

Please be advised we will be doing limited maintenance on Monday, May 4th 2009 between the hours of 5:00-5:30 pm PDT.  We will be replacing a degraded memcache instance on our Standard Network deployed at Amazon EC2.  We do not expect any interruption of API traffic or degradation of service. 

Please note Premium Network clients are not impacted.

If you would like to follow us on Twitter as we make these changes, you can follow @MasheryOps for the updates as they occur. 

As always, you may contact us at support@mashery.com or contact your Client Services Manager.

Thanks!