{"id":913,"date":"2020-06-01T14:05:30","date_gmt":"2020-06-01T17:05:30","guid":{"rendered":"https:\/\/micheladrianomedeiros.com.br\/blog\/?p=913"},"modified":"2020-06-01T14:08:08","modified_gmt":"2020-06-01T17:08:08","slug":"construindo-ferramentas-com-github-6","status":"publish","type":"post","link":"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/","title":{"rendered":"Construindo Ferramentas com GitHub #6"},"content":{"rendered":"\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_84 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/#Sucesso_200_ou_201\" >Sucesso (200 ou 201)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/#JSON_Incorreto_400\" >JSON Incorreto (400)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/#JSON_Improprio_422\" >JSON Impr\u00f3prio (422)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/#Criado_com_Sucesso_201\" >Criado com Sucesso (201)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-6\/#Nada_Mudou_304\" >Nada Mudou (304)<\/a><\/li><\/ul><\/nav><\/div>\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Sucesso_200_ou_201\"><\/span><strong>Sucesso (200 ou 201)<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Se voc\u00ea j\u00e1 trabalhou com algum cliente HTTP, voc\u00ea sabe que o status code \u201c200\u201d significa sucesso. GitHub ir\u00e1 responder com o status code 200 quando seu pedido a URL e par\u00e2metros estiverem corretos. Se voc\u00ea pedir um conte\u00fado ao servidor, ent\u00e3o voc\u00ea ir\u00e1 receber o status code 201, indicando o sucesso na cria\u00e7\u00e3o do servidor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No programa Insomnia coloque no get a chamada <a href=\"https:\/\/api.github.com\">https:\/\/api.github.com<\/a>. Veja que o status da resposta \u00e9 200.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"454\" height=\"439\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-1.png\" alt=\"\" class=\"wp-image-915\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-1.png 454w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-1-300x290.png 300w\" sizes=\"auto, (max-width: 454px) 100vw, 454px\" \/><\/figure><\/div>\n\n\n\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"JSON_Incorreto_400\"><\/span><strong>JSON Incorreto (400)<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Se seu payload (o JSON que foi enviado como pedido) \u00e9 inv\u00e1lido, a API GitHub ir\u00e1 responder com o erro 400. Em -u coloque o seu nome de usu\u00e1rio do GitHub, no meu caso \u00e9 blackzig.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"567\" height=\"441\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-3.png\" alt=\"\" class=\"wp-image-917\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-3.png 567w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-3-300x233.png 300w\" sizes=\"auto, (max-width: 567px) 100vw, 567px\" \/><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Tentamos gerar um novo gist para utilizar o endpoint descrito na documenta\u00e7\u00e3o API Gist. O erro aconteceu porque n\u00f3s n\u00e3o utilizamos JSON. O payload foi enviado utilizando a chave -d.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">GitHub responde com conselhos para olhar a documenta\u00e7\u00e3o para saber o formato correto na documentation_url key dentro da resposta JSON. Veja que usamos a chave -X POST e passou o valor para o cURL fazer o pedido para o GitHub.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"JSON_Improprio_422\"><\/span><strong>JSON Impr\u00f3prio (422)<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Se qualquer campo do seu pedido for inv\u00e1lido, o GitHub ir\u00e1 responder com o erro 422. A documenta\u00e7\u00e3o indica como o payload JSON deve ser:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">{<br>&nbsp;&nbsp;&nbsp; &#8220;description&#8221;: &#8220;the description for this gist&#8221;,<br>&nbsp;&nbsp;&nbsp; &#8220;public&#8221;: true,<br>&nbsp;&nbsp;&nbsp; &#8220;files&#8221;: {<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&#8220;file1.txt&#8221;: {<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&#8220;content&#8221;: &#8220;String file contents&#8221;<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;}<br>&nbsp;&nbsp;&nbsp; }<br>}<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O que acontece se o JSON for v\u00e1lido, mas com algum campo incorreto?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Fiz a chamada de POST com o endere\u00e7o <a href=\"https:\/\/api.github.com\/gists\">https:\/\/api.github.com\/gists<\/a> e utilizando Basic no programa Insomnia.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"484\" height=\"157\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-4.png\" alt=\"\" class=\"wp-image-918\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-4.png 484w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-4-300x97.png 300w\" sizes=\"auto, (max-width: 484px) 100vw, 484px\" \/><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"481\" height=\"306\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-6.png\" alt=\"\" class=\"wp-image-920\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-6.png 481w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-6-300x191.png 300w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-6-312x198.png 312w\" sizes=\"auto, (max-width: 481px) 100vw, 481px\" \/><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Veja a resposta.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"469\" height=\"439\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-7.png\" alt=\"\" class=\"wp-image-921\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-7.png 469w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-7-300x281.png 300w\" sizes=\"auto, (max-width: 469px) 100vw, 469px\" \/><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">H\u00e1 duas coisas importantes nessa situa\u00e7\u00e3o: se voltou o erro 422, indica que o JSON \u00e9 v\u00e1lido, mas os campos est\u00e3o incorretos. A resposta indica o motivo: n\u00e3o encontramos o arquivo chave dentro do pedido do payload.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Criado_com_Sucesso_201\"><\/span><strong>Criado com Sucesso (201)<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">O que acontece se o JSON for inv\u00e1lido, mas para o pedido o JSON \u00e9 v\u00e1lido? Utilizando o Insomnia:<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-9.png\" alt=\"\" class=\"wp-image-924\" width=\"483\" height=\"191\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-9.png 483w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-9-300x119.png 300w\" sizes=\"auto, (max-width: 483px) 100vw, 483px\" \/><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"567\" height=\"378\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-10.png\" alt=\"\" class=\"wp-image-925\" srcset=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-10.png 567w, https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2020\/06\/image-10-300x200.png 300w\" sizes=\"auto, (max-width: 567px) 100vw, 567px\" \/><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Sucesso! Criamos um gist e conseguimos o status code 201 indicando que tudo deu certo.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Nada_Mudou_304\"><\/span><strong>Nada Mudou (304)<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">O c\u00f3digo 304 \u00e9 parecido com o c\u00f3digo 200, eles dizem ao cliente: sim, seu pedido foi processado com sucesso. Eles d\u00e3o um pouco mais de informa\u00e7\u00f5es, contudo, ele diz ao cliente que os dados n\u00e3o foram mudados desde o \u00faltimo pedido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Essa informa\u00e7\u00e3o \u00e9 valiosa se voc\u00ea est\u00e1 preocupado com seu limite de uso (que n\u00e3o \u00e9 o nosso caso). N\u00e3o explicamos como os limites funcionam, ent\u00e3o vamos ver como isso funciona para depois voltar para o c\u00f3digo 304.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Fonte: Building Tools with GitHub: Customize Your Workflow (English Edition)<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Sucesso (200 ou 201) Se voc\u00ea j\u00e1 trabalhou com algum cliente HTTP, voc\u00ea sabe que o status code \u201c200\u201d significa sucesso. GitHub ir\u00e1 responder com o status code 200 quando seu pedido a URL e par\u00e2metros estiverem corretos. Se voc\u00ea pedir um conte\u00fado ao servidor, ent\u00e3o voc\u00ea ir\u00e1 receber o status code 201, indicando o [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":360,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[70,71],"tags":[],"class_list":["post-913","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-git","category-github"],"_links":{"self":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/913","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/comments?post=913"}],"version-history":[{"count":2,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/913\/revisions"}],"predecessor-version":[{"id":926,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/913\/revisions\/926"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media\/360"}],"wp:attachment":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media?parent=913"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/categories?post=913"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/tags?post=913"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}