GET https://leadforge.nl/api/v1/me
Vraagt read
Bij welke werkruimte je sleutel hoort en welke rechten hij heeft. Handig om een nieuwe sleutel te testen en om in je eigen systeem vast te leggen bij welke werkruimte hij hoort.
Authenticatie
Een API-sleutel met het recht read in de header Authorization: Bearer lf_live_.... Zie Authenticatie.
Parameters
Geen.
Antwoord
Dit adres geeft de velden direct terug, zonder data-omhulsel.
Velden
| Naam | Type | Beschrijving |
|---|---|---|
| client.id | tekst (uuid) | Het id van de werkruimte waar de sleutel bij hoort. |
| client.name | tekst of null | De naam van de werkruimte. |
| scopes | lijst van tekst | De rechten van de sleutel: read, write of allebei. |
| Status | Code | Wanneer |
|---|---|---|
| 200 | De sleutel is geldig. | |
| 401 | unauthorized | Geen, een onbekende of een ingetrokken sleutel. |
| 403 | forbidden | De sleutel heeft geen read, of hoort niet bij precies één werkruimte. |
| 429 | rate_limited | Meer dan 120 verzoeken per minuut. |
Voorbeeld
Verzoek
curl https://leadforge.nl/api/v1/me \
-H "Authorization: Bearer LF_LIVE_SLEUTEL"
const antwoord = await fetch('https://leadforge.nl/api/v1/me', {
headers: { Authorization: 'Bearer LF_LIVE_SLEUTEL' }
});
console.log(await antwoord.json());
import json
import urllib.request
verzoek = urllib.request.Request(
"https://leadforge.nl/api/v1/me",
headers={"Authorization": "Bearer LF_LIVE_SLEUTEL"},
)
with urllib.request.urlopen(verzoek) as antwoord:
print(json.load(antwoord))
{
"client": {
"id": "<werkruimte-id>",
"name": "Klant A"
},
"scopes": ["read"]
}