Lorna,

the API looks quite fine to me. Here are just some minimalistic remarks:

– I couldn’t find a real reason for the “verbose” flag. Is there any resource, that has that many fields so that it makes sense to hide some by default?

– Although “resultsperpage” is semanically more substantial, I’d personally go for “limit” instead. At least for me, it’s more intuitive and I bet lots of web devs have the same issue. Thanks MySQL! ;)

– It might make sense to use XML instead of JSON, for better extensibility and validation purposes.

I wondered why I cannot see any comments here: http://api.joind.in/v2/talks/3240/comments It’s the comment list of my “Advanced OO patterns” talk at DPC, which shows quite some comments on the website.

Cheers,
Toby