freeCodeCamp/curriculum/challenges/portuguese/05-apis-and-microservices/basic-node-and-express/get-data-from-post-requests.md

id, title, challengeType, forumTopicId, dashedName

id	title	challengeType	forumTopicId	dashedName
587d7fb2367417b2b2512bf8	Obter dados de solicitações de POST	2	301511	get-data-from-post-requests

--description--

Monte um handler POST no caminho /name. É o mesmo caminho de antes. Nós preparamos um formulário na página inicial html. Ele vai enviar os mesmos dados do exercício 10 (string de consulta). Se o body-parser estiver configurado corretamente, você deverá encontrar os parâmetros do objeto req.body. Dê uma olhada no exemplo habitual da biblioteca:

route: POST '/library'
urlencoded_body: userId=546&bookId=6754
req.body: {userId: '546', bookId: '6754'}

Responda com o mesmo objeto JSON usado antes: {name: 'firstname lastname'}. Teste se seu endpoint (URL) funciona usando o formulário html que fornecemos na página inicial do aplicativo.

Dica: existem vários outros métodos http além de GET e POST. Por convenção, existem correspondências entre o verbo http e a operação que você vai executar no servidor. O mapeamento convencional é:

POST (às vezes, PUT) – Cria um novo recurso usando a informação enviada com a requisição,

GET - Lê um recurso existente sem modificá-lo,

PUT ou PATCH (às vezes, POST) – Atualiza um recurso usando os dados enviados,

DELETE=> Exclui um recurso.

Existem também alguns outros métodos que são usados para estabelecer uma conexão com o servidor. Com a exceção de GET, todos os outros métodos listados acima podem ter uma payload(carga) (exemplo: os dados enviados no corpo da requisição). O middleware body-parser também funciona com esses métodos.

--hints--

Teste 1 : O endpoint (URL) da API deve responder com o nome correto

(getUserInput) =>
  $.post(getUserInput('url') + '/name', { first: 'Mick', last: 'Jagger' }).then(
    (data) => {
      assert.equal(
        data.name,
        'Mick Jagger',
        'Test 1: "POST /name" route does not behave as expected'
      );
    },
    (xhr) => {
      throw new Error(xhr.responseText);
    }
  );

Teste 2: O endpoint da API deve responder com o nome correto

(getUserInput) =>
  $.post(getUserInput('url') + '/name', {
    first: 'Keith',
    last: 'Richards'
  }).then(
    (data) => {
      assert.equal(
        data.name,
        'Keith Richards',
        'Test 2: "POST /name" route does not behave as expected'
      );
    },
    (xhr) => {
      throw new Error(xhr.responseText);
    }
  );

--solutions--

/**
  Backend challenges don't need solutions, 
  because they would need to be tested against a full working project. 
  Please check our contributing guidelines to learn more.
*/