another iteration of API experiments

This relates to issue #9, also see discussion under pull request #12 and #11