{"id":5667,"date":"2020-01-22T08:00:41","date_gmt":"2020-01-22T10:00:41","guid":{"rendered":"http:\/\/www.rcodigital.com.br\/blog\/?p=5667"},"modified":"2020-01-22T08:00:41","modified_gmt":"2020-01-22T10:00:41","slug":"apis-guia-de-metodos-http-comuns","status":"publish","type":"post","link":"https:\/\/www.intergate.net.br\/blog\/apis-guia-de-metodos-http-comuns\/","title":{"rendered":"APIs – Guia de m\u00e9todos HTTP comuns"},"content":{"rendered":"\n\t\t\t\t\n

N\u00f3s tendemos a tomar m\u00e9todos HTTP<\/strong> como garantidos. No espa\u00e7o de desenvolvimento da API, os m\u00e9todos s\u00e3o semelhantes ao alfabeto – geralmente usados, raramente considerados. Os desenvolvedores de API<\/a> geralmente usam apenas GET<\/strong> , PUT<\/strong> ou POST<\/strong> , mas o registro oficial HTTP Request Method lista 39<\/strong> verbos HTTP totais<\/strong> , cada um fornecendo um m\u00e9todo para intera\u00e7\u00f5es avan\u00e7adas. Neste artigo, analisamos 9 dos mais comuns.<\/p>\n\n\n\n\n\n\n\n

Abaixo, revise 9 m\u00e9todos HTTP padr\u00e3o e fa\u00e7a uma an\u00e1lise detalhada do que cada m\u00e9todo faz.  Lembre-se de que os m\u00e9todos da API podem ser usados \u200b\u200bde v\u00e1rias maneiras; portanto, seu caso de uso pode diferir em fun\u00e7\u00e3o. <\/p>\n\n\n\n

M\u00e9todos de recupera\u00e7\u00e3o de recursos<\/h2>\n\n\n\n

Talvez o mais \u00f3bvio dos m\u00e9todos que discutiremos hoje, GET e HEAD, seja projetado para recuperar um recurso de uma maneira espec\u00edfica. Essa \u00e9 uma das funcionalidades mais comumente entendidas, bem como algumas das mais usadas.<\/p>\n\n\n\n

GET<\/h2>\n\n\n\n

O m\u00e9todo GET foi projetado para solicitar um recurso espec\u00edfico<\/strong>. Em ess\u00eancia, literalmente “obt\u00e9m” o recurso em quest\u00e3o e \u00e9 bastante limitado a essa a\u00e7\u00e3o. Solicita\u00e7\u00f5es GET devem recuperar apenas dados, deixando outros m\u00e9todos para executar as outras a\u00e7\u00f5es transformadoras.<\/p>\n\n\n\n

\"\"<\/a><\/figure><\/div>\n\n\n\n

HEAD<\/h2>\n\n\n\n

HEAD \u00e9 um m\u00e9todo interessante, na medida em que reflete algumas funcionalidades de outro M\u00c9TODO enquanto desbloqueia possibilidades adicionais<\/strong>. HEAD solicita uma resposta GET de um determinado recurso, mas com o corpo da resposta excisado. Embora isso possa parecer simplista demais, ele permite maior flexibilidade e poder para outras extens\u00f5es de API<\/a> – por exemplo, voc\u00ea pode passar os cabe\u00e7alhos de um recurso para outra solicita\u00e7\u00e3o, na tentativa de imitar um ambiente ou situa\u00e7\u00e3o de solicita\u00e7\u00e3o diferente, o que \u00e9 extremamente \u00fatil para testar e solu\u00e7\u00e3o de problemas.<\/p>\n\n\n\n

M\u00e9todos de modifica\u00e7\u00e3o de recursos<\/h2>\n\n\n\n

Existem muitos m\u00e9todos que podem alterar fundamentalmente o recurso. Esses m\u00e9todos podem incluir a localiza\u00e7\u00e3o de um recurso, a substitui\u00e7\u00e3o de um recurso de destino e at\u00e9 a atualiza\u00e7\u00e3o de atributos sobre o recurso.<\/p>\n\n\n\n

PUT<\/h2>\n\n\n\n

PUT \u00e9 um pouco o oposto polar de GET. Enquanto GET solicita um recurso espec\u00edfico, PUT coloca esse recurso no diret\u00f3rio remoto<\/strong>. Deve-se observar que PUT pressup\u00f5e que o recurso n\u00e3o existe ou que o recurso pode ser substitu\u00eddo – ao usar PUT, todas as representa\u00e7\u00f5es do recurso de destino ser\u00e3o substitu\u00eddas pela carga \u00fatil.<\/p>\n\n\n\n

PATCH<\/h2>\n\n\n\n

PATCH foi projetado para modificar parcialmente um recurso direcionado<\/strong>. Em outras palavras, enquanto PUT coloca um recurso no servi\u00e7o de destino, PATCH modifica esse recurso, em vez de substitu\u00ed-lo. Essa \u00e9 uma boa maneira de atualizar arquivos ou vers\u00f5es.<\/p>\n\n\n\n

DELETE<\/h2>\n\n\n\n

DELETE \u00e9 o m\u00e9todo mais claro nesta lista porque faz exatamente o que est\u00e1 na lata – DELETE exclui um recurso direcionado.<\/strong> A resposta t\u00edpica para um m\u00e9todo de exclus\u00e3o \u00e9 simplesmente responder com um status “OK” – o recurso foi exclu\u00eddo ou n\u00e3o.<\/p>\n\n\n\n

POST<\/h2>\n\n\n\n

O POST afeta os recursos relacionados anexados a um recurso de destino<\/strong>. O POST permite que uma API envie um atributo ou entidade para um determinado recurso; na pr\u00e1tica, isso significa que o recurso direcionado recebe um recurso subordinado que faz parte de uma cole\u00e7\u00e3o maior. Como exemplo, um uso do POST seria adicionar uma imagem a um recurso – no caso da PetStore, podemos adicionar uma foto que possa ser usada para ajudar a adotar nossos filhotes de abrigo.<\/p>\n\n\n\n

OPTIONS<\/h2>\n\n\n\n

O m\u00e9todo OPTIONS altera as diferentes op\u00e7\u00f5es de comunica\u00e7\u00e3o mantidas pelo recurso de destino<\/strong>. Isso pode ser usado para abrir mais canais de comunica\u00e7\u00e3o e tranc\u00e1-los – por esse motivo, o m\u00e9todo OPTIONS deve ser considerado semelhante a uma torneira que pode ser aberta e fechada com relativa granularidade.<\/p>\n\n\n\n

M\u00e9todos do ambiente de recursos<\/h2>\n\n\n\n

Nem toda mudan\u00e7a em um recurso precisa ser uma altera\u00e7\u00e3o no conte\u00fado do recurso. Existem dois m\u00e9todos principais que interagem mais com o ambiente do recurso do que com o pr\u00f3prio recurso.<\/p>\n\n\n\n

\"\"<\/a><\/figure><\/div>\n\n\n\n

TRACE<\/h2>\n\n\n\n

TRACE \u00e9 um m\u00e9todo que executa um teste de retorno de mensagem. Este teste permite observar o caminho para o recurso direcionado, identificando poss\u00edveis pontos de falha. Esta \u00e9 uma ferramenta altamente poderosa, por mais simples que seja, pois reflete o caminho essencial de um recurso.<\/p>\n\n\n\n

CONNECT<\/h2>\n\n\n\n

CONNECT \u00e9 um m\u00e9todo que cria comunica\u00e7\u00e3o com um recurso em vez de interagir diretamente com o referido recurso. CONNECT estabelece um t\u00fanel para o servidor que ret\u00e9m o recurso de destino.<\/strong><\/p>\n\n\n\n

Conclus\u00e3o<\/h2>\n\n\n\n

Os m\u00e9todos HTTP conduzem as intera\u00e7\u00f5es fundamentais da API<\/a> que vemos dia ap\u00f3s dia. Compreender esses m\u00e9todos, sua idempot\u00eancia e seguran\u00e7a \u00e9 um passo fundamental para entender o espa\u00e7o da API com uma aprecia\u00e7\u00e3o substancialmente mais profunda.<\/p>\n\n\n\n

Pressupostos comuns e \u201centendimento geral\u201d levaram alguns desses m\u00e9todos e termos relacionados a serem mal interpretados, mal utilizados e mal aplicados. No entanto, com alguns conceitos b\u00e1sicos simples, os conceitos podem ser facilmente aprendidos e compreendidos.<\/p>\n\n\n\n

A InterGATE<\/a> faz sua API, fale conosco!<\/p>\n\n\n\n\t\t\t\t\t\t