Api principles (preliminary, very rough draft)

@pedrocunha what do you mean by "Personally without seeing what others are doing find it a bit weird to lookup on metadata for this"?