REST APIs

Call a REST API from a function with fetch, using the GET, DELETE, POST, PUT, and PATCH methods with JSON data.

Last updated

View as Markdown Agent setup

Make outbound HTTP requests from a function using the fetch API, covering the GET, DELETE, POST, PUT, and PATCH methods with JSON data. Use these snippets when your function needs to call a REST API, whether to read data, submit a form, or update a resource, while running close to the user on Azion’s global network.

Examples

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 })

How it works

Each example calls fetch() with a URL and an options object whose method field selects the HTTP verb. Request metadata such as authorization tokens and the Content-Type are passed through headers, either as a Headers instance or a plain object, while bodies are sent as FormData or as a JSON string produced by JSON.stringify. The returned promise resolves to a Response, which the snippets read with .then(response => response.json()) or .text() to consume the payload, and .catch() handles any network or parsing error. Running these requests on a distributed architecture keeps the calling logic close to the user.

JavaScript examples

Browse the other syntax patterns in the collection.

Fetch API

Read the reference for the fetch implementation these snippets call.

Web APIs

Check which other JavaScript APIs Azion Runtime supports.

Functions limits

Confirm how many outbound requests a single invocation can make.

How to use Real-Time Metrics

Read the consumption this function has generated, product by product.