Api principles (preliminary, very rough draft)

curious about this one. Personally without seeing what others are doing find it a bit weird to lookup on metadata for this. I would expect this to be included on the body itself. I'm afraid that Metadata headers will be used only for 1-time offs.