API Authenticatie

API Authenticatie

Om gebruik te maken van de Matrixian API’s heeft u een abonnement nodig op de specifieke API die u wilt gebruiken.

👉 Abonnementen en API-sleutels zijn beschikbaar via de Matrixian Portal.

De base URL voor alle endpoints is:

https://api.matrixian.com/v1/

API-sleutel aanvragen

1. Log in op het Matrixian Portal.

2. Sluit een abonnement af op de gewenste API.

3. Haal de persoonlijke API key op vanuit de portal.

Authenticatie

Alle requests moeten geauthenticeerd worden met een Authorization header. Gebruik hiervoor het volgende formaat:

Authorization: Bearer <api-key>

Vervang <api-key> met uw persoonlijke sleutel.

Voorbeeld van de header:

Authorization: Bearer abcd1234efgh5678ijkl

Voorbeeld request

Hieronder ziet u een voorbeeldrequest naar de mx-house-details API.

curl --location 'https://api.matrixian.com/v1/mx-house-details?postalCode=1251LB&houseNumber=42&houseLetter=b' \
--header 'Authorization: Bearer <api-key>'

Response

Bij een succesvolle call ontvangt u een JSON-response met de gevraagde data. Bijvoorbeeld:

{
    "id": "3066da09-6bcb-48e3-a4f8-84dda89585fb",
    "params": {
        "houseLetter": "b",
        "houseNumber": "42",
        "postalCode": "1251LB"
    },
    "data": {
        "objectType": "2-onder-1-kapwoning",
        "buildYear": 1955,
        "livingSurface": 100,
        "otherIndoorSpace": 8,
        "useSurface": 108,
        "parcelSurface": 293,
        "energyLabel": "D",
        "numberOfRooms": 4,
        "numberOfBedrooms": 3,
        "numberOfBathrooms": 1,
        "numberOfToilets": 1,
        "attachedOutdoorSpace": null,
        "externalStorageSpace": 19,
        "volume": 379,
        "postalCode": "1251LB",
        "houseNumber": 42,
        "houseLetter": "b",
        "houseNumberExt": null
    },
    "error": {},
    "meta": {},
    "status": "success"
}

---

👉 Tip: Er is altijd een actief abonnement nodig op de betreffende API én een geldige API key uit de Matrixian Portal.

---

API-sleutel rotatie

Om je API-sleutel te roteren, navigeer je naar de API keys pagina in het portal, en klik je op de knop Rotate My API Key. Let op: De oude sleutel wordt onmiddellijk gedeactiveerd.