API Integration

This guide will show you how to obtain an API token within the GoodAccess Control Panel for accessing the API and performing authorized operations.

This feature is available in the Premium plan and higher.

For more detailed API integration documentation, we recommend visiting the Postman Documentation or downloading the collection and importing it into Postman.

Obtaining API token

Here, add a new integration or edit an existing one.

Select scopes of the integration, set expiration and allowed IP addresses, and generate a token.

Additionally, you can monitor the activity and communication of the integration from this interface.

Please note: Immediately after being generated, you will see the token for a limited period. It is important to save the token in a secure place, as it provides access to the API and can be used to perform operations. After this period has expired, the token will be secured and you won’t be able to access it.

Your token can be used to authorize HTTP requests to the GoodAccess API. Each request must include an Authorization header with the token written as Bearer <token>.

See the examples at the bottom of the page for correct syntax.

Treat your token like a password and store it securely. For example, use the methods env and dotenv to store it in a development environment.

Testing connection to GoodAccess API

To test your API connection, send an authenticated request to the test-connection endpoint. If the connection is successful, you will get a 200 return code.

Test Connection

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

Responseobject

get

/api/v1/test-connection

GET /api/v1/test-connection HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

{
  "message": "Connection has been established successfully."
}

Below are examples of how to call the test endpoint in various languages.

curl -i https://integration.goodaccess.com/api/v1/test-connection \
  -H "Authorization: Bearer <integration_token>"

const axios = require('axios');

const url = 'https://integration.goodaccess.com/api/v1/test-connection';
const token = '<integration_token>';

axios.get(url, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
})
.then(response => {
 //...
})
.catch(error => {
  //...
});

<?php

$url = 'https://integration.goodaccess.com/api/v1/test-connection';
$token = '<integration_token>';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $token,
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);

API Reference

PreviousGeo Restrictions NextAPI Reference

Last updated 7 months ago

Was this helpful?

hashtagObtaining API token

hashtagTesting connection to GoodAccess API

hashtagTest Connection

hashtagAPI Reference

Obtaining API token

Testing connection to GoodAccess API

Test Connection

API Reference