10 - Atualizando uma operação (PUT) As APIs PUT são usadas pri | Curso de design de APIs REST

10 - Atualizando uma operação (PUT)
As APIs PUT são usadas principalmente para atualizar um recurso existente (se o recurso não existir, a API pode decidir criar um novo recurso ou não).

Se um novo recurso tiver sido criado pela API PUT, o servidor deverá informar o agente do usuário por meio do código de resposta HTTP 201 (Criado) e, se um recurso existente for modificado, a resposta 200 (OK) ou 204 (Sem Conteúdo) código deve ser enviado para indicar a conclusão bem-sucedida da solicitação.

Se a solicitação passar por um cache e o URI de solicitação identificar uma ou mais entidades armazenadas no cache, essas entradas deverão ser tratadas como obsoletas. As respostas a esse método não podem ser armazenadas em cache.

Exemplos:

HTTP PUT http://www.appdomain.com/users/48848
HTTP PUT http://www.appdomain.com/users/48848/accounts/2744

Nota: A diferença entre as APIs POST e PUT pode ser observada em URIs de solicitação: solicitações POST são feitas de coleções de recursos, enquanto as solicitações PUT são feitas no recurso individual.