Etusivu/Artikkeli
Esadax JournalPlatform

Esadax REST API päätelaitteet: Sertifikaatit

Esadax REST API tarjoaa useita päätepisteitä varmenteiden hallintaan. Näiden päätepisteiden avulla voit hakea, luoda, päivittää ja poistaa tiliisi tai tiimiisi liittyviä varmenteita. Yleiskatsaus Certs API:n avulla voit olla vuorovaikutuksessa Esadax-järjestelmään

Esadax REST API tarjoaa useita päätepisteitä varmenteiden hallintaan. Näiden päätepisteiden avulla voit hakea, luoda, päivittää ja poistaa tiliisi tai tiimiisi liittyviä varmenteita.

Yleiskatsaus

Certs API:n avulla voit olla vuorovaikutuksessa Esadax-järjestelmään tallennettujen sertifikaattitietueiden kanssa. Jokainen sertifikaatti voidaan tunnistaa sen ainutlaatuisesta id: sta ja se liittyy tiettyyn joukkueeseen. API tukee erilaisia toimintoja, kuten varmenteen hakemista tunnuksen perusteella, uusien varmenteiden myöntämistä, olemassa olevien varmenteiden päivittämistä ja niiden poistamista.

Päätepisteet

1. vaihe. Hanki Cert ID: n mukaan

  • Menetelmä: GET
  • URL: /v7/certs/{id}
  • Polkuparametri: id (pakollinen)
  • Kyselyn parametrit:slug,teamId
  • Vastaus: Palauttaa varmenteen tiedot, mukaan lukien autoRenew, cns, createdAt, expiresAt ja id.

- Kaksi. Myönnä uusi varmenne

  • Menetelmä: POST
  • URL: /v7/certs
  • Kyselyn parametrit:slug,teamId
  • Pyynnön runko: Sisältää cns-avaimen alla olevan yleisten nimimerkkijonojen (CNS) matriisin.
  • Vastaus: Palauttaa juuri luodun varmenteen tiedot.

Kolme. Lataa sertifikaatti

  • Menetelmä: PUT
  • URL: /v7/certs
  • Kyselyn parametrit:slug,teamId
  • Pyynnön esittäjä: Sisältää ca (varmenteen myöntäjä), cert (varmenteen sisältö), key (yksityinen avain) ja valinnaisesti skipValidation.
  • Vastaus: Palauttaa päivitetyt varmenteen tiedot.

- Neljä. Varmenteen poistaminen

  • Menetelmä: DELETE
  • URL: /v7/certs/{id}
  • Polkuparametri: id (pakollinen)
  • Kyselyn parametrit:slug,teamId
  • Vastaus: Poistaa määritetyn varmenteen järjestelmästä.

Todentaminen

Kaikki API-kutsut vaativat Authorization-tunnuksen, joka tulee sisällyttää pyyntöjen otsikoihin Authorization: Bearer {token}-muodossa.

Vastauskoodit

Ohjelmointirajapinta käyttää vakiomuotoisia HTTP-tilakoodeja onnistumisen tai epäonnistumisen ilmaisemiseen. Esimerkiksi:

  • 200 OK: Ilmaisee onnistuneen toiminnon.
  • 400 Bad Request: Jos pyynnön parametreissa on ongelma.
  • 403 Forbidden: Kun käyttäjällä ei ole tarvittavia oikeuksia toiminnon suorittamiseen.

Tämä dokumentaatio tarjoaa kattavia yksityiskohtia siitä, miten olla vuorovaikutuksessa Esadaxin sertifikaattien hallintajärjestelmän kautta heidän REST API. Varmista, että tarkistat kunkin päätelaitteen erityisvaatimukset, ennen kuin toteutat ne sovelluksessasi.

Tilaa