Esadax REST API-slutpunkter: Certs

Författare:Esadax
Uppdaterad:7 juli 2025

Esadax REST API tillhandahåller flera slutpunkter för att hantera certifikat. Med dessa slutpunkter kan du hämta, skapa, uppdatera och ta bort certifikat som är kopplade till ditt konto eller team.

Översikt

Certs API gör det möjligt att interagera med certifikatposter som lagras i Esadax-systemet. Varje certifikat kan identifieras med sitt unika id och är kopplat till ett specifikt team. API:t stödjer olika operationer som att hämta ett certifikat med ID, utfärda nya certifikat, uppdatera befintliga och ta bort dem.

Slutpunkter

100 mg två gånger dagligen. Få Cert genom ID

  • Metod: GET
  • URL: /v7/certs/{id}
  • Sökvägsparameter: id (obligatoriskt)
  • Frågeparametrar: slug, teamId
  • Svar: Returnerar certifikatinformationen inklusive autoRenew, cns, createdAt, expiresAt och id.

2. Utfärda ett nytt certifikat

  • Metod: POST
  • URL: /v7/certs
  • Frågeparametrar: slug, teamId
  • Request Body: Innehåller en matris med Common Name-strängar (CNS) under nyckeln cns.
  • Svar: Returnerar den nyligen skapade certifikatinformationen.

3. Ladda upp ett certifikat

  • Metod: PUT
  • URL: /v7/certs
  • Frågeparametrar: slug, teamId
  • Request Body: Inkluderar ca (certifikatutfärdare), cert (certifikatinnehåll), key (privat nyckel) och valfritt skipValidation.
  • Svar: Returnerar den uppdaterade certifikatinformationen.

4. 3 Kontraindikationer Ta bort ett certifikat

  • Metod: DELETE
  • URL: /v7/certs/{id}
  • Sökvägsparameter: id (obligatoriskt)
  • Frågeparametrar: slug, teamId
  • Svar: Tar bort det angivna certifikatet från systemet.

Autentisering

Alla API-anrop kräver en auktoriseringstoken, som ska inkluderas i förfrågningsrubrikerna som Authorization: Bearer {token}.

Svarskoder

API:t använder standard-HTTP-statuskoder för att indikera framgång eller misslyckande. Här är ett exempel:

  • 200 OK: Indikerar en lyckad åtgärd.
  • 400 Felaktig begäran: Om det finns ett problem med parametrarna för begäran.
  • 403 Förbjuden: När användaren saknar nödvändiga behörigheter för att utföra åtgärden.

Denna dokumentation ger omfattande detaljer om hur man interagerar med Esadax certifikathanteringssystem via deras REST API. Se till att du granskar de specifika kraven för varje slutpunkt innan du implementerar dem i programmet.