Authentication ​

The Netzo API currently supports the following authentication methods:

• API key: used to authenticate external requests (recommended)
• Bearer token: used internally by the Netzo Web Application

API Key Authentication ​

To make a request, you need to create an API key and provide it in either:

• 'x-api-key' header for example { 'x-api-key': API_KEY } (recommended)

curl -H "x-api-key: API_KEY" https://api.netzo.io/RESOURCE

curl -H "x-api-key: API_KEY" https://api.netzo.io/RESOURCE

fetch('https://api.netzo.io/RESOURCE', {
  headers: { 'x-api-key': 'API_KEY' },
})

fetch('https://api.netzo.io/RESOURCE', {
  headers: { 'x-api-key': 'API_KEY' },
})

• apiKey query parameter for example /RESOURCE?apiKey=${API_KEY}

curl -H "Content-Type: application/json" -X GET https://api.netzo.io/RESOURCE?apiKey=API_KEY

curl -H "Content-Type: application/json" -X GET https://api.netzo.io/RESOURCE?apiKey=API_KEY

fetch('https://api.netzo.io/RESOURCE?apiKey=API_KEY')

fetch('https://api.netzo.io/RESOURCE?apiKey=API_KEY')

Bearer Token Authentication ​

Authenticating HTTP requests in this way is a two step process. First you have to obtain a valid JWT from the authentication service by POSTing the strategy you want to use. This however is not meant to be used for external requests to the API. Use API key authentication instead.