Sponsored by Dragon Age: Origins
Follow the Dragon Age: Origins development team on Twitter view!
twitter.com/DragonAge - EA presents BioWare's new dark fantasy epic Dragon Age: Origins. '9/10' from Game Informer.
30 Comments
- mattza, on 10/12/2007, -0/+4programmableweb.com. No need for Digg to reinvent the wheel.
- joshpeek, on 10/12/2007, -2/+6REST is definitely the way to go.
- oniTony, on 10/12/2007, -0/+2fairly good article. web APIs are great, and well made web APIs are awesome
- prockcore, on 10/12/2007, -1/+2"Other than RSS, there are no "clean and simple" standards for web APIs."
um... RSS isn't an API. XMLRPC is a clean and simple standard.
"Full disclosure - I work for eBay."
It shows. - unimatrixZxero, on 10/12/2007, -0/+1I'll give REST a try. Good night.
- sdether, on 10/12/2007, -0/+1REST is simpler than SOAP when you are handcoding the provider or consumer. But since REST is a technique not a standard or even a specification per se, there is no such thing as machine discoverable REST.
So what's simpler, pointing your WSDL consumer at the the WSDL and receiving object stubs you can immediately code against and use without dealing with the network layer, or figuring out what this particular REST implementation does and handcoding your objects to consume the service? - geekdreams, on 10/12/2007, -0/+1http://digg.com/userblock/557274
- tybris, on 10/12/2007, -0/+1It wouldn't be very difficult making a REST extension for WSDL, but for some odd reason no one does.
- mattza, on 10/12/2007, -0/+1Thats awfully rude of you, Sean. RSS is indeed a way to implement "Web APIs" -- we are talking here about ways to serve up data. RSS can be used for that. eBay does it, Yahoo does it, etc.... XMLRPC is standard, but it is not in use much at all for implementing Web APIs.
- CaughtThinking, on 10/12/2007, -1/+1@prockore
You have problems with reading comprehension; he said RSS is a standard. You clearly don't know your history either, ebay was one of the first to roll out web apis that the world took notice of. - mattza, on 10/12/2007, -2/+2Other than RSS, there are no "clean and simple" standards for web APIs. No, REST is not a standard -- its a technique. I happen to disagree with the article about REST (GET is simple -- PUT is not, its often not supported by certain environemnts where you might want to use Web APIs, such as in online widget containers like live.com). Each Web API vendor who has implemented REST has done so differently.
Overall a good article though -- very good point about designing for updates. This is crucial. I'd add the following points off the top of my head:
6. Design for efficient data transfer
7. Put in place the appropriate amount of security checks, no more, no less
8. Listen to users (or potential users) of your Web APIs. They will quickly become more adept at using your APIs than you are, so they will have good advice
9. An API that exposes a useless service is itself useless. Make sure that what you are exposing has value
10. Create liberal usage terms that allow for commercial use. Not everyone is a hobbyist.
Full disclosure - I work for eBay. We have Web APIs that we are very proud of. - csrster, on 10/12/2007, -1/+1Given tools like wsdl2java or wsdl2ruby it's kinda no-contest (from the consumer's perspective). I like push-the-button-and-away-you-go programming.
- Atomic1fire, on 10/12/2007, -2/+2digg needs a best web apis list now
- tybris, on 10/12/2007, -1/+1There is a lot of echoing going on regarding SOAP, it is actually very simple and in many ways easier to use than REST. There are very good reasons to employ REST, but simplicity over SOAP is certainly not one of them.
- quick1, on 10/12/2007, -0/+0Another thing concerning soap wsdl's, is to keep your xml schema's simple (this also goes for corba idls). I.e., avoid defining a ton of complex types where a simple set of strings will do the job. This makes web services much easier to interact with, and can also help to avoid binding problems. While some might argue that such decisions are implementation specific, I would point out that I would much rather see an api of performFunction1(request), then have a low level interface that requires me to implement five methods and pass a bunch of complex types around (not to mention its more efficient). Just my opinion....
- Dotnetsky, on 10/12/2007, -1/+1Sorry, but to me all this article does is state the obvious. And I agree that REST is a trick, a technique, not a robust API - type spec. SOAP, on the other hand is a spec.
- geekdreams, on 10/12/2007, -2/+1Wrong page...? :p
- kozie, on 10/12/2007, -2/+1There is always a need for digg to reinvent everything, how long have you been around?
Reinventing != Xerox. - sdubois92, on 10/12/2007, -2/+1I think .Mac is wonderful technology. It works seemlesly with all of the iLife programs and it helps out alot. I agree it needs a major overhaul (including a price reduction) but this is something that makes a mac that much better than a PC
- PktLoss, on 10/12/2007, -10/+6If you're interested in writing an API in PHP this book covers it well:
http://www.amazon.com/o/ASIN/0764589547/preinheimerco-20?creative=327641&camp=14573&adid=09GBZ53N1S2GSJH6YFC3&link_code=as1
Professional Web APIs with PHP
(I wrote it, so forgive the plug and the use of my associates id) - ashishkc5, on 10/12/2007, -5/+0Hi This is my comment I am going to add my fourth comment. This is comment
- ashishkc5, on 10/12/2007, -5/+0Hi This is my sub comment I am going to add my second sub comment. This is comment
- ashishkc5, on 10/12/2007, -5/+0Hi This is my sub comment I am going to add my first sub comment. This is comment
- ashishkc5, on 10/12/2007, -5/+0Hi This is my sub comment I am going to add my third sub comment. This is comment
- ambethia, on 10/12/2007, -7/+1REST FTW!
- theratboy, on 10/12/2007, -7/+1cs owns web apis
- ashishkc5, on 10/12/2007, -7/+0Hi This is my comment I am going to add my first comment
- ashishkc5, on 10/12/2007, -7/+0Hi This is my comment I am going to add my third comment. This is comment
- ashishkc5, on 10/12/2007, -7/+0Hi This is my comment I am going to add my second comment. This is comment
- Tuta, on 10/12/2007, -9/+0isn't this a dupe?


What is Digg?