APIs REST

Chame uma API REST a partir de uma função com fetch, usando os métodos GET, DELETE, POST, PUT e PATCH com dados JSON.

Última atualização

Ver como Markdown Configurar agente

Faça requisições HTTP de saída a partir de uma função usando a API fetch, cobrindo os métodos GET, DELETE, POST, PUT e PATCH com dados JSON. Use estes trechos de código quando sua função precisar chamar uma API REST, seja para ler dados, enviar um formulário ou atualizar um recurso, executando próximo ao usuário na rede global da Azion.

Exemplos

Get

JavaScript
01 var myHeaders = new Headers();
02 myHeaders.append("Accept", "application/json; version=3");
03 myHeaders.append("Authorization", "Token [TOKEN VALUE]");
04
05 var requestOptions = {
06 method: 'GET',
07 headers: myHeaders,
08 redirect: 'follow'
09 };
10
11 fetch("https://api.azionapi.net/digital_certificates/", requestOptions)
12 .then(response => response.text())
13 .then(result => console.log(result))
14 .catch(error => console.log('error', error));

Delete

JavaScript
01 fetch('https://example.com/delete-item/' + id, {
02 method: 'DELETE',
03 })
04 .then(res => res.text()) // or res.json()
05 .then(res => console.log(res))

Post

JavaScript
01 function createNewProfile(profile) {
02 const formData = new FormData();
03 formData.append('first_name', profile.firstName);
04 formData.append('last_name', profile.lastName);
05 formData.append('email', profile.email);
06 return fetch('http://example.com/api/v1/registration', {
07 method: 'POST',
08 body: formData
09 }).then(response => response.json())
10 }
11 createNewProfile(profile)
12 .then((json) => {
13 // handle success
14 })
15 .catch(error => error);

Put

JavaScript
01 const putMethod = {
02 method: 'PUT', // Method itself
03 headers: {
04 'Content-type': 'application/json; charset=UTF-8' // Indicates the content
05 },
06 body: JSON.stringify(someData) // We send data in JSON format
07 }
08 // make the HTTP put request using fetch api
09 fetch(url, putMethod)
10 .then(response => response.json())
11 .then(data => console.log(data)) // Manipulate the data retrieved back, if we want to do something with it
12 .catch(err => console.log(err)) // Do something with the error

Patch

JavaScript
01 const API_URL = 'https://api.azion.net/'
02 const API_PATH = 'api/v3/'
03 fetch(API_URL + API_PATH + 'tasks', {
04 headers: {
05 'Accept': 'application/json',
06 'Content-Type': 'application/json'
07 },
08 method: 'patch',
09 body: JSON.stringify( { task: task } )
10 })

Como funciona

Cada exemplo chama fetch() com uma URL e um objeto de opções cujo campo method seleciona o verbo HTTP. Metadados da requisição, como tokens de autorização e o Content-Type, são passados em headers, seja como uma instância de Headers ou como um objeto simples, enquanto os corpos são enviados como FormData ou como uma string JSON produzida por JSON.stringify. A promise retornada resolve em um Response, que os trechos de código leem com .then(response => response.json()) ou .text() para consumir o conteúdo, e .catch() trata qualquer erro de rede ou de parsing. Executar essas requisições em uma arquitetura distribuída mantém a lógica de chamada próxima ao usuário.

Recursos relacionados

Exemplos em JavaScript

Consulte os outros padrões de sintaxe da coleção.

Fetch API

Leia a referência da implementação de fetch que estes trechos de código chamam.

Web APIs

Verifique quais outras APIs JavaScript o Azion Runtime suporta.

Limites

Confirme quantas requisições de saída uma única invocação pode fazer.

Como usar o Real-Time Metrics

Leia o consumo que esta função gerou, produto por produto.