{"id":690,"date":"2015-12-14T16:27:10","date_gmt":"2015-12-14T19:27:10","guid":{"rendered":"https:\/\/www.semeru.com.br\/blog\/?p=690"},"modified":"2022-12-21T10:27:01","modified_gmt":"2022-12-21T13:27:01","slug":"http-status-codes-em-servicos-rest","status":"publish","type":"post","link":"https:\/\/www.semeru.com.br\/blog\/http-status-codes-em-servicos-rest\/","title":{"rendered":"HTTP Status Codes em Servi\u00e7os REST"},"content":{"rendered":"

Uma boa pr\u00e1tica ao se desenvolver servi\u00e7os REST \u00e9 retornar status codes adequados a cada opera\u00e7\u00e3o executada. Isso tem uma import\u00e2ncia ainda maior quando se trata de uma exce\u00e7\u00e3o, uma vez que diferentementemente de um servi\u00e7o SOAP uma aplica\u00e7\u00e3o verdadeiramente REST n\u00e3o retorna a exception para o usu\u00e1rio. Sendo assim \u00e9 fortemente recomendado que ao se desenvolver uma API REST se v\u00e1 al\u00e9m dos status code 200 e 500 OK e falha respectivamente.<\/p>\n

\"HTTP
HTTP Status Codes<\/figcaption><\/figure>\n

200 OK<\/strong> – Request de cria\u00e7\u00e3o ou dele\u00e7\u00e3o executada com sucesso.<\/p>\n

201 Created<\/strong> – Cria\u00e7\u00e3o de uma fila, topico, fila tempor\u00e1ria, t\u00f3pico tempor\u00e1ria, session, producer, consumer, listener, queue browser ou menssagem realizada com sucesso.<\/p>\n

204 No Content<\/strong> – dele\u00e7\u00e3o de uma fila, t\u00f3pico, sess\u00e3o, producer ou listener bem sucedida mas sem retorno de conte\u00fado.<\/p>\n

400 Bad Request<\/strong> – O path informado est\u00e1 em umformato incorreto, um parametro ou valor do corpo da requisi\u00e7\u00e3o n\u00e3o est\u00e1 formatado corretamente ou um par\u00e2metro onbrigat\u00f3rio n\u00e3o foi informado,
\nou est\u00e1 formatado corretamente mas pode estar eventualmente inv\u00e1lido (por exemplo, o ID informado n\u00e3o exite – NullPointerException, o conte\u00fado retornado \u00e9 muito grande ou o ID informado j\u00e1 est\u00e1 em uso).<\/p>\n

403 Forbidden<\/strong> – O cliente n\u00e3o tem permiss\u00e3o para executar requisi\u00e7\u00f5es na opera\u00e7\u00e3o em quest\u00e3o.<\/p>\n

404 Not Found<\/strong> – o objeto requisitado pelo path n\u00e3o existe(NullPointerException).<\/p>\n

405 Method Not Allowed<\/strong> – O usu\u00e1rio n\u00e3o tem permiss\u00e3o de acesso ao path.<\/p>\n

409 Conflict<\/strong> – Um objeto j\u00e1 foi criado com as mesmas informa\u00e7\u00f5es.<\/p>\n

500 Internal Server Error <\/strong>– Ocorreu uma falha no servidor, podendo ser desde uma falha no SQL por exemplo.<\/p>\n

A pr\u00e1tica de retornar os status code corretos torna seus servi\u00e7os mais amig\u00e1veis ao cliente facilitando a integra\u00e7\u00e3o com outros sistemas. Nos pr\u00f3ximos posts botaremos a m\u00e3o na massa desenvolvendo a nossa propria API\/Servi\u00e7o REST.<\/p>\n

Botando em pr\u00e1tica<\/h2>\n

Em breve estar\u00e3o dispon\u00edveis dois posts Criando o primeiro endpoint REST com SpringBoot<\/a> e Documentando aplica\u00e7\u00f5es RESTfull com SpringBoot e Swagger <\/a> com exemplos pr\u00e1ticos.<\/p>\n

Treinamentos relacionados com este post<\/h2>\n


\n
\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n


\n<\/a><\/p>\n

Refer\u00eancias:<\/h2>\n

DZone<\/a><\/p>\n

Java World<\/a><\/p>\n

StackOverflow<\/a><\/p>\n

Oracle<\/a><\/p>\n

<\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"

Uma boa pr\u00e1tica ao se desenvolver servi\u00e7os REST \u00e9 retornar status codes adequados a cada opera\u00e7\u00e3o executada. Isso tem uma import\u00e2ncia ainda maior quando se trata de uma exce\u00e7\u00e3o, uma vez que diferentementemente de um servi\u00e7o SOAP uma aplica\u00e7\u00e3o verdadeiramente REST n\u00e3o retorna a exception para o usu\u00e1rio. Sendo assim \u00e9 fortemente recomendado que ao […]<\/p>\n

\n
\n
<\/div>\n<\/div>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[117,102,116,120,121],"tags":[205,191,204,206,207],"_links":{"self":[{"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/posts\/690"}],"collection":[{"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/comments?post=690"}],"version-history":[{"count":15,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/posts\/690\/revisions"}],"predecessor-version":[{"id":1500,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/posts\/690\/revisions\/1500"}],"wp:attachment":[{"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/media?parent=690"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/categories?post=690"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.semeru.com.br\/blog\/wp-json\/wp\/v2\/tags?post=690"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}