API

Alles wat u in de webinterface doet, kunt u ook geautomatiseerd doen — via een gedocumenteerde REST-API die dezelfde controles doorloopt als de interface zelf.

Lees de API-documentatie Vraag een demo aan

Wat levert het u op?

Uw netwerkbeheer in uw eigen processen

Nieuwe werkplekken uit uw personeelssysteem, apparaten uit uw inkoopproces, controles vanuit uw monitoring — zonder dat iemand het handmatig overtypt in een tweede systeem.

🔗

Koppel aan wat u al gebruikt

Een gewone REST-API met JSON: bruikbaar vanuit een script, een automatiseringsplatform of uw eigen applicatie, zonder speciale client.

📜

Gedocumenteerd, niet afgeleid

Een machineleesbare specificatie en een doorbladerbare naslag horen bij het product. U hoeft niets te reverse-engineeren uit de interface.

🔒

Dezelfde regels als de interface

Validatie, rechten en licentiegrenzen zijn identiek. Via de API kan niets wat via de interface niet mag.

Technische mogelijkheden

Wat kunt u precies doen?

✓

Volledig beheer van uw inventaris Apparaten, VLAN's, switches, apparaat- en switchgroepen en hun onderlinge koppelingen: opvragen, aanmaken, wijzigen en verwijderen.

✓

Poorten koppelen en losmaken Zoek een vrije switchpoort op, koppel er een apparaat aan, leg het patchpunt vast en maak de koppeling later weer los.

✓

Live acties op switch en apparaat Een poort herstarten, in- of uitschakelen, opnieuw laten authenticeren of een ping uitvoeren — vanaf de appliance of vanaf de switch waar het apparaat op zit.

✓

Status van honderden apparaten in één aanroep Een periodiek ververste statusweergave met een tijdstempel erbij, zodat u weet hoe actueel de gegevens zijn.

✓

Certificaten voor 802.1x Certificaten uitgeven, intrekken en downloaden voor apparaten die op certificaat authenticeren.

✓

Servicepoorten bedienen Vraag op welke servicepoorten openstaan, open er een voor een vaste duur in een VLAN, of sluit hem eerder af.

✓

Taken volgen die langer duren Werk dat op de achtergrond loopt krijgt een taaknummer dat u kunt opvragen, annuleren of opnieuw laten uitvoeren.

✓

Veilig opnieuw proberen Met een idempotentiesleutel levert een herhaalde aanroep na een netwerkfout hetzelfde resultaat op, in plaats van een tweede keer hetzelfde aan te maken.

✓

Doorbladeren van lange lijsten Lijsten worden in stukken opgehaald met een cursor, zodat een grote inventaris geen probleem is.

✓

API-sleutels met grenzen Elke sleutel heeft eigen rechten, kan een geldigheidsperiode krijgen en kan beperkt worden tot vaste IP-adressen of subnetten.

✓

Verzoeklimieten die uw switches beschermen Elke sleutel heeft een eigen aantal verzoeken per minuut, met een apart en veel krapper budget voor de aanroepen die daadwerkelijk een sessie naar een switch openen. Een integratie die op hol slaat legt uw netwerkapparatuur zo niet plat. Elk antwoord vertelt hoeveel ruimte er over is, zodat een koppeling zichzelf kan doseren.

✓

Voorspelbare foutmeldingen Elke fout heeft een vaste code en een leesbare beschrijving; bij validatiefouten krijgt u per veld terug wat er mis is.

✓

Webhooks de andere kant op Laat de appliance zelf een melding sturen naar uw eigen systeem zodra er iets gebeurt, in plaats van dat u erop moet pollen.

Waarom PrivateLAN?

De API is onderdeel van het product, geen bijproduct

Bij veel beheersoftware is de API een afgeleide die achterloopt op de interface. Bij PrivateLAN loopt de API door dezelfde validatie, dezelfde rechten en dezelfde licentiecontroles als de webinterface — het is dezelfde logica, niet een tweede implementatie die uit de pas kan gaan lopen.

De specificatie en de naslag worden met het product meegeleverd en zijn op uw eigen appliance te bekijken. Ook de ingebouwde AI-assistent werkt via diezelfde API, zodat wat de assistent kan en wat u kunt automatiseren per definitie gelijk oplopen.

Lees de API-documentatie

GET /api/v1/device?limit=50
Authorization: Bearer pl_live_…

{
  "success": true,
  "data": [
    {
      "device_id": 12,
      "device_hostname": "WS-0421",
      "device_ip": "10.30.4.21"
    }
  ]
}

Wilt u PrivateLAN koppelen aan uw eigen systemen?

Bekijk de API-documentatie of bespreek uw koppeling met ons.

Lees de API-documentatie Neem contact op

API