in reply to API communication

You might like to check my blog post on the general rules for writing APIs.

In Section Seekers of Perl Wisdom