add notice that this is a short term API with a pointer to the RESTful API in design on apiary.org