← Pagina Inicial

Rotas de API

1 - 2 - 3 - 4

Criando rotas de API

As rotas da API permitem criar um endpoint da API dentro de um aplicativo Next.js. Você pode fazer isso criando uma função dentro do diretório pages/api que possui o seguinte formato:

// req = request data, res = response data
export default (req, res) => {
  // ...
}

Eles podem ser implantados como Funções Serverless (também conhecidas como Lambdas).

Criando um terminal de API simples

Vamos tentar. Crie um arquivo chamado hello.js em pages/api com o seguinte código:

export default (req, res) => {
  res.status(200).json({ text: 'Hello' })
}

Tente acessá-lo em http://localhost:3000/api/hello. Você deve ver {"text": "Hello"}. Observe que:

• req é uma instância do http.IncomingMessage, além de alguns middlewares pré-criados que você pode ver aqui.
• res é uma instância do http.ServerResponse, além de algumas funções auxiliares que você pode ver aqui.

É isso aí! Antes de encerrarmos esta lição, vamos falar sobre algumas dicas para usar rotas de API na próxima página.

← Pagina Inicial