User : Permissions

Aangemaakt : 16-07-2025
Laatste update: -

Omschrijving

Toon alle permissies die de API key heeft samen met de ipadressen die toegang hebben.

Endpoint

GET https://api.nextname.nl/v2/user/permissions

Parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
permissions	Array	Alle permissies van de API key
allowed_ips	Array	Alle ipadressen die toegang hebben tot de API voor deze API key

Voorbeeld

Beschrijving:
Haal de permissies van de API key op

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/user/permissions";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/user-permissions

Antwoord:

HTTP/1.1 200 Ok
Content-Type: application/json;charset=utf-8

{
  "permissions": [
    "GET /v2/contacts",
    "GET /v2/contacts/{handle}",
    "POST /v2/contacts/{handle}",
    "DELETE /v2/contacts/{handle}",
    "POST /v2/contacts/{handle}/validate",
    "POST /v2/contacts/{handle}/validate/cancel",
    "POST /v2/contacts/{handle}/tlddata/{registry}",
    "PUT /v2/contacts/{handle}/tlddata/{registry}",
    "GET /v2/nsgroups",
    "GET /v2/nsgroups/{name}",
    "POST /v2/nsgroups/{name}",
    "DELETE /v2/nsgroups/{name}",
    "POST /v2/domains/{domain}/auth_code",
    "POST /v2/domain-availability",
    "POST /v2/domains/{domain}/auto_renewal",
    "POST /v2/domains/{domain}/contacts",
    "POST /v2/domains/{domain}/trade",
    "DELETE /v2/domains/{domain}",
    "POST /v2/domains/{domain}/restore",
    "POST /v2/domains/{domain}/renew",
    "PUT /v2/domains/{domain}/dnssec",
    "POST /v2/domains/{domain}/transfer_lock",
    "POST /v2/domains/{domain}/ns",
    "GET /v2/domains",
    "GET /v2/domains/{domain}",
    "POST /v2/domains/{domain}",
    "PUT /v2/domains/{domain}/tags",
    "GET /v2/domains/{domain}/dnszone",
    "PATCH /v2/domains/{domain}/dnszone",
    "GET /v2/domains/{domain}/dnszone/records",
    "PATCH /v2/domains/{domain}/dnszone/records",
    "PUT /v2/domains/{domain}/dnszone/records",
    "GET /v2/dns/templates",
    "GET /v2/dns/templates/{dnstemplate}/records",
    "GET /v2/dns/templates/{dnstemplate}/history",
    "PATCH /v2/dns/templates/{dnstemplate}",
    "POST /v2/dns/templates",
    "DELETE /v2/dns/templates",
    "PATCH /v2/dns/dnstemplates/{dnstemplate}/records",
    "PUT /v2/dns/dnstemplates/{dnstemplate}/records",
    "GET /v2/tlds/pricing",
    "GET /v2/account/removed-domains",
    "GET /v2/transfers",
    "GET /v2/transfers/{domain}",
    "POST /v2/transfers/{domain}",
    "GET /v2/user/permissions"
  ],
  "allowed_ips": [
    "192.0.2.100",
    "203.0.113.25",
    "2001:db8:85a3::8a2e:370:7334"
  ]
}