Update apiary.apib

Changes in the method types (POST and PUT), include authentication header and HTTP response codes.