REST POST — создание ресурса или выполнение операции, не являющейся идемпотентной (по умолчанию).

Использование

  • Создание ресурса в коллекции: POST /orders с телом.

  • Запуск действий/команд: POST /auth/login.

Правила

  • Ответы: 201 Created с Location на новый ресурс; 200/202 для команд.

  • Не является safe/idempotent; для идемпотентности используйте Idempotency-Key/контракт.

Пример:

POST /orders HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"itemId":42,"qty":2}

HTTP/1.1 201 Created
Location: /orders/987
Content-Type: application/json

{"id":987,"status":"created","itemId":42,"qty":2}

Создаём ресурс в коллекции и получаем ссылку на него.

Последнее обновление