Take the 2-minute tour ×
Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. It's 100% free, no registration required.

Stack Overflow API as seen by the SOAPI parser and code generator:

With the API freeze, changes to the vast API should slow to a trickle, making manual maintenance possible. At this milestone, I have suspended code generation and manually refactored the entire SOAPI library.

In doing so I have reduced the redundancies that are the inevitable result of code generation so the model is much cleaner and presents an accurate view of the API.

One area which I will refrain from refactoring further until v1.0 are the parameters. It should be obvious that the parameter types would benefit from abstraction into interfaces and base classes but until this critical area is truly frozen I will continue to use discreet parameter types for each route.

StackAuth methods are now folded into SOAPI.

NOTE: Some browsers will not give you a full resolution view on images this size. FF and IE seem to behave, Chome is choking a bit and won't zoom to full resolution. If you have trouble viewing the images clearly try another browser or save them to disk.

Routes

Routes

Full Size


Parameters

Parameters

Full Size


Responses

Responses

Full Size

share|improve this question
1  
that's pretty interesting, thanks. –  systempuntoout Jun 17 '10 at 12:23
    
@system - glad you liked it. –  Sky Sanders Jun 17 '10 at 13:57
    
There are a few places where some more normalization could be implemented with some specific code generation rules but until the API stops moving so fast I don't see the point in wasting time. –  Sky Sanders Jun 17 '10 at 13:57
    
You get an upvote for including pretty charts. –  Thomas McDonald Jun 18 '10 at 10:45
    
Believe it or not, Opera Mini has no problem displaying the images. –  Nathan Osman Jun 27 '10 at 16:16

1 Answer 1

I find this to be a very useful view of the data. Thanks for doing this. One suggestion would be to include the types for each property. This would make it easy at a glance to see more of what each thing represents.

share|improve this answer
1  
ask and ye shall receive. –  Sky Sanders Jun 17 '10 at 23:30

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .