Add a vignette about the API

[romainfrancois]

I don't think a vignette is the best vehicle for that.

[eddelbuettel]

Closing this now as there is no action item here.