Startpagina/Artikel
Esadax JournalPlatform

Esadax REST API eindpunten: Certs

De Esadax REST API biedt verschillende eindpunten om certificaten te beheren. Met deze eindpunten kunt u certificaten ophalen, maken, bijwerken en verwijderen die aan uw account of team zijn gekoppeld. Overzicht Met

De Esadax REST API biedt verschillende eindpunten om certificaten te beheren. Met deze eindpunten kunt u certificaten ophalen, maken, bijwerken en verwijderen die aan uw account of team zijn gekoppeld.

Overzicht

Met de Certs API kunt u communiceren met certificaatrecords die zijn opgeslagen in het Esadax-systeem. Elk certificaat kan worden geïdentificeerd door zijn unieke id en is gekoppeld aan een specifiek team. De API ondersteunt verschillende bewerkingen, zoals het ophalen van een certificaat op ID, het uitgeven van nieuwe certificaten, het bijwerken van bestaande certificaten en het verwijderen ervan.

Eindpunten

1.1. Krijg Cert door ID

  • Methode: GET
  • URL: /v7/certs/{id}
  • Padparameter: id (verplicht)
  • Query parameters:slug,teamId
  • Response: retourneert de certificaatgegevens, waaronder autoRenew, cns, createdAt, expiresAt en id.

2. Een nieuw certificaat uitgeven

  • Methode: POST
  • URL: /v7/certs
  • Query parameters:slug,teamId
  • Request Body: Bevat een array van Common Name Strings (CNS) onder de sleutel cns.
  • Response: retourneert de nieuw gemaakte certificaatgegevens.

Drie. Een certificaat uploaden

  • Werkwijze: PUT
  • URL: /v7/certs
  • Query parameters:slug,teamId
  • Request Body: Inclusief ca (certificeringsinstantie), cert (certificaatinhoud), key (privésleutel) en optioneel skipValidation.
  • Response: retourneert de bijgewerkte certificaatgegevens.

4.3 Contra-indicaties Een certificaat verwijderen

  • Methode: VERWIJDEREN
  • URL: /v7/certs/{id}
  • Padparameter: id (verplicht)
  • Query parameters:slug,teamId
  • Response: Verwijdert het opgegeven certificaat uit het systeem.

Verificatie

Voor alle API-aanroepen is een autorisatietoken vereist, dat in de verzoekheaders moet worden opgenomen als Authorization: Bearer {token}.

Reactiecodes

De API gebruikt standaard HTTP-statuscodes om succes of mislukking aan te geven. Bijvoorbeeld:

  • 200 OK: Geeft een succesvolle bewerking aan.
  • 400 Bad Request: Als er een probleem is met de aanvraagparameters.
  • 403 Forbidden: Wanneer de gebruiker niet over de benodigde rechten beschikt om de actie uit te voeren.

Deze documentatie geeft uitgebreide details over hoe te communiceren met het certificaatbeheersysteem van Esadax via hun REST API. Zorg ervoor dat u de specifieke vereisten voor elk eindpunt bekijkt voordat u deze in uw toepassing implementeert.

Abonneren