API

API: API is-a Web API

2008-06-14T20:36:40.0012Z

The properties presented by this schema don't seem to reflect an API as much as a Web API.

In particular, the Site property isn't appropriate for a normal API. One could rename the site property provided_by, or one could rename this type.

Protocol is also problematic for a normal API, since it tends to suggest some method of transport used (XML, JSON, etc).

Python: Common Python idioms and basic programs?

2008-01-17T01:23:25.0000Z

Interesting that you should ask. I'm working on some Metaweb API documentation which you can see in my private area which is quite similar to this, and Nick Thompson (nix) was working on something that he hoped would be a generalised kind of API doc schema -- see his apiary domain. So yeah, I reckon it could be useful to do what you suggest. Perhaps work up some examples of what you're thinking of, so we can check it out?

Python: Common Python idioms and basic programs?

2008-01-15T22:29:01.0034Z

Hey, would it be useful to put common python idioms and some simple example programs somewhere? If so, where is the right place?

Digg API: Protocols

2007-07-07T03:19:40.0012Z

I'm not sure the best way to do this, but I feel that the previously listed XML, PHP, and JS “protocols” were incorrect, as none of these are protocols. They do not define the method by which the data is transferred, as a protocol must; instead, they are the formatting for the data itself. Obviously, here HTTP is used as the protocol, although I do not think this is the intended meaning of the Protocol field (as almost all APIs are over HTTP).

Perhaps the field needs to be renamed Data Transfer Types?