Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I am looking for some advices, resources or articles about how to expose a Platform API to outside developers.

My main concern is what is the standards or best approach to do that, basically I have a set of REST API services of the platform and need to understand how to address the following issus :

  • API Hosting and Management in general (should we use online api management tools like apigee or mashrey?)
  • Developer Keys, permissions
  • Developer tools, documentations
  • throttling
  • Reporting
  • Logging/Auditing
  • Authentication and Authorization

It is also great if you can point out to some articles that explain how Facebook or Twitter or Google are doing this, or abstract architecture and management best practices on how to open Platform API to the public users.


share|improve this question

migrated from Oct 21 '11 at 17:22

This question came from our site for professional and enthusiast programmers.

closed as not a real question by MainMa, Steve Evers, Walter, Mark Trapp Oct 26 '11 at 13:19

It's difficult to tell what is being asked here. This question is ambiguous, vague, incomplete, overly broad, or rhetorical and cannot be reasonably answered in its current form. For help clarifying this question so that it can be reopened, visit the help center.If this question can be reworded to fit the rules in the help center, please edit the question.

up vote 1 down vote accepted

Step 1: read the Facebook and Amazon development documents.

(Don't read Google, some folks think they're not as good at creating an API. Read this to see what mistakes Google may have made.

These documents will cover most of your questions. They will show a number of good practices. You'll have to choose which you think is best.

share|improve this answer
Thank you very much, really helpful information. – Ahmad Alkhawaja Oct 22 '11 at 17:52
I find amazon documentation hard to follow, any ideas how to get to authentication/authorization documents in amazon aws website? – Ahmad Alkhawaja Oct 22 '11 at 21:40

Not the answer you're looking for? Browse other questions tagged or ask your own question.