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,expiresAtjaid.
- 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 valinnaisestiskipValidation. - 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.
