De 'authenticated endpoints' worden beveiligd door middel van een JWT token en een Hash. Om te beginnen met het opzetten van een gebruiker waarmee u de 'authenticated endpoints' kunt gebruiken kunt u hier klikken.

Nadat u inlog gegevens heeft verkregen kunt u beginnen met het gebruiken van de endpoints. Om een endpoint te kunnen gebruiken zult u als eerst het login eindpunt moeten gebruiken. Het resulterende JWT token kunt u gebruiken bij een van de 'authenticated eindpunten', en is een uur lang geldig.

De hash is een stukje 2FA. Dit wilt zeggen dat er naast de JWT token nog een extra stap nodig is om uzelf te authentiseren. De hash wordt opgemaakt met een SHA256 algoritme en bestaat uit uw klant nummer en een hash key die u krijgt na het aanmaken van een gebruiker. Hieronder ziet u een aantal voorbeelden waarin er een SHA256 string wordt opgebouwd uit een klant nummer en hash key.

Door de JWT token en Hash mee te geven in een 'authenticated endpoint' zal u geauthentiseerd worden, tenzij u hier geen gespecificeerde toegang tot heeft.

C#

using System;
using System.Security.Cryptography;
using System.Text;

public class HashExample
{
    public static void Main(string[] args)
    {
        string customer = "123";
        string hash_key = "Your Hash Key";
     
        // Create a SHA256   
        SHA256 sha256Hash = SHA256.Create();
        // ComputeHash
        byte[] content = Encoding.UTF8.GetBytes(customer + hash_key);
        byte[] bytes = sha256Hash.ComputeHash(content);
 
        // Convert byte array to a string   
        StringBuilder builder = new StringBuilder();
        for (int i = 0; i < bytes.Length; i++)
        {
            builder.Append(bytes[i].ToString("x2"));
        }
 
        string hash = builder.ToString();
    }
}

JavaScript

const { createHash } = require('crypto');

const customer = "123";
const hash_key = "Your Hash Key"

let hash = createHash('sha256').update(customer + hash_key).digest('hex');

Python

from hashlib import sha256

customer = "123"
hash_key = "Your Hash Key"
hash = sha256((customer + hash_key).encode('utf-8')).hexdigest()