SSLmarket API-ja a tanúsítványok megrendeléséhez

Az SSLmarket API lehetővé teszi a TLS tanúsítványok megrendelését. Az API megkönnyíti kínálatunk szinte összes tanúsítványának megrendelését. Kiadás után könnyedén letöltheti ezeket. Az alábbiakban leírást talál, amely segít megkezdeni a tanúsítványok megrendelését az API-n keresztül, amivel időt takaríthat meg!

Az API különösen akkor segít, ha több tanúsítványt rendel meg egyszerre. Ez segít felgyorsítani a megrendeléseket, és arra koncentrálhat, ami valóban fontos a vállalkozása számára.

Az SSLmarket API fontos jellemzői

Az SSLmarket API-n (Application Programming Interface) keresztül szinte minden típusú tanúsítványt megrendelhet kínálatunkból (kivéve a nem automatizálható termékeket). Csak adja meg az SSLmarket megrendelési űrlap által megkövetelt összes információt azonos módon, és a megrendelés bekerül a fiókjába. Az API támogatja az összes tanúsítványparamétert, beleértve a SAN-okat (a tanúsítvány több domainnel) .

  • Minden típusú tanúsítvány megrendelése (néhány kivételtől eltekintve)
  • Könnyű tanúsítvány letöltés a kiállítás után
  • Az összes rendelési paraméter meghatározása
  • Egy kattintásos megrendelés (az eszköz segítségével)
  • Gyorsítsa fel a folyamatokat és spóroljon időt
  • Alapértelmezett adatok beállítása a vállalkozás számára

Az SSLmarket API használata

Az API kétféleképpen használható. Az ajánlott módszer a rendszerébe vagy a saját kezelőfelületren történő implementáció a tanúsítványok megrendeléséhez. Ehhez elég elolvasnia az alábbi információkat. A második módszer azoknak az ügyfeleknek alkalmas, akik nem tudják, hogyan kell programozni, vagy nem állnak rendelkezésre programozók. Az általunk jelenleg fejlesztés alatt álló felhasználói felület használatával könnyedén megrendelést adhat le az API segítségével, de az ügyfél részéről implentáció nélkül. Ennek eredményeként a tanúsítványokkal és azok kezelésével is felgyorsítja munkáját.

Kezdőlépések az SSLmarket API-val

Az SSLmarket API-t bármelyik ügyfelünk használhatja. Nincs szükség semmilyen szerződéskötésre vagy formaságokra. Csak annyit kell tennie, hogy bejelentkezik a fiókjába, és a beállításokban aktiválja a „Fiókhozzáférés API-n keresztül” funkciót. Ez létrehoz egy egyedi API kulcsot az SSLmarket API eléréséhez (a kulcs az adott fiókhoz van kötve). Ezután adja át a dokumentációt, leírást a programozójának.

A következő URL használatával hívja le az API-t: https://www.sslmarket.hu/api

Kérés autentizálása

Valamennyi API-lekérdezésnek rendelkeznie kell egy hozzáférési hitelesítési tokennel (X-Auth-Token), amelyet a HTTP lekérdezés fejlécében kell megadni. A „Fiókhozzáférés API-n keresztül” aktiválása után a fiókbeállításokban található.

GET /api/order/list HTTP/1.1
Host: sslmarket.cz
X-Auth-Token: {{AUTH_TOKEN}}

Visszatérési értékek

Sikeres endpoint lehívás után az API 2XX állapotú HTTP válaszkódot ad vissza. Ha a hívás sikertelen, az API visszaad egy 4XX válaszállapú kódot; a válasz törzsében megtalálja a hiba típusát (karakterláncát) és annak leírását.

SSLmarket API elérhető funkciói

Az alábbiakban megtalálja azon API-k listáját, amelyek segítségével ajánlatunkból megrendelheti és letöltheti az összes digitális tanúsítványt.

Minden funkció a saját végpont/endpointján keresztül érhető el, amelyhez a függvény meghívásához szükséges paramétereket tartalmazó kérést küld. A bemeneti paraméterek kötelezőekre és nem kötelezőek (választható) vannak osztva, amelyeket el kell küldenie a kérelemben. Minden funkcióhoz le van írva a használata, a végpont címe, a bemeneti és kimeneti paraméterek leírása, valamint a válasz formátuma.

A funkció visszaállítja az API-n elérhető termékek listáját.

GET /product/list
  • HTTP válaszállapot kód: 200
  • Adatformátum válasz: application/json

Kimeneti paraméterek

Név Típus Leírás
products array
.. product_type string Termék típusa. A paramáter értéke ssl_certificate vagy client_certificate
.. product_code string Termék kód
.. title string Termék neve
.. type string hitelesítő hatóság CA
.. validate_type string Tanúsítvány hitelesítésének módja. A paraméter értéke dv, ov vagy ev
.. csr_required string Kötelező CSR. A paraméter értéke true vagy false
.. max_years string Tanúsítvány érvényessége
.. min_san_values int SAN-ok minimális száma
.. max_san_values int SAN-ok maximális száma

  
{
    "products": [
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-standard-ssl",
            "type": "DigiCert",
            "title": "Standard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-wildcard",
            "type": "DigiCert",
            "title": "WildCard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "digicert-ev-ssl",
            "type": "DigiCert",
            "title": "EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-standard-dv-ssl",
            "type": "GeoTrust",
            "title": "DV SSL",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-geotrust-wildcard-dv",
            "type": "GeoTrust",
            "title": "DV SSL Wildcard",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-dv",
            "type": "RapidSSL",
            "title": "RapidSSL DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-1",
            "type": "DigiCert",
            "title": "Client Premium Class 1",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ssl",
            "type": "DigiCert",
            "title": "Secure Site SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-123-dv",
            "type": "Thawte",
            "title": "SSL 123 DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-client-premium-class-2",
            "type": "DigiCert",
            "title": "Client Premium Class 2",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "rapidssl-rapidssl-wildcard-dv",
            "type": "RapidSSL",
            "title": "RapidSSL Wildcard DV",
            "validate_type": "dv",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov",
            "type": "Thawte",
            "title": "SSL Webserver OV",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ov-wildcard",
            "type": "Thawte",
            "title": "SSL Webserver OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ov-wildcard",
            "type": "GeoTrust",
            "title": "TrueBusiness ID OV Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-500",
            "type": "DigiCert",
            "title": "Document Signing - Individual (500)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "geotrust-truebusiness-id-ev",
            "type": "GeoTrust",
            "title": "TrueBusiness ID EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "thawte-ssl-webserver-ev",
            "type": "Thawte",
            "title": "SSL Webserver EV",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-individual-2000",
            "type": "DigiCert",
            "title": "Document Signing - Individual (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ev-ssl",
            "type": "DigiCert",
            "title": "Secure Site Pro EV SSL",
            "validate_type": "ev",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-2000",
            "type": "DigiCert",
            "title": "Document Signing Organization (2000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "client_certificate",
            "product_code": "quovadis-rsassa-pss-smime",
            "type": "QuoVadis",
            "title": "RSASSA-PSS S/MIME",
            "validate_type": "qv",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-wildcard-ssl",
            "type": "DigiCert",
            "title": "Secure Site Wildcard SSL",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        },
        {
            "product_type": "client_certificate",
            "product_code": "digicert-document-signing-organization-5000",
            "type": "DigiCert",
            "title": "Document Signing Organization (5000)",
            "validate_type": "ev",
            "csr_required": "false",
            "max_years": "3",
            "min_san_values": "0",
            "max_san_values": "0"
        },
        {
            "product_type": "ssl_certificate",
            "product_code": "symantec-secure-site-pro-ssl-wildcard",
            "type": "Digicert",
            "title": "Secure Site Pro Wildcard",
            "validate_type": "ov",
            "csr_required": "true",
            "max_years": "6",
            "min_san_values": "0",
            "max_san_values": "250"
        }
    ]
}
 

A funkció egy adott ügyfélszámlán történő megrendelésre szolgál.

POST /order/certificate/{{PRODUCT_CODE}}
  • {{PRODUCT_CODE}} - kód produktu
  • HTTP válasz állapotkód: 201
  • Adatformátum kérés: application/json
  • Adatformátum válasz: application/json

Vstupní parametry

Név Típus Kötelező Leírás
domain string igen domain neve, amelyre a tanúsítvány kiállítva lesz
dns_names array nem SAN-ként hozzáadott domainek helye
years int igen Tanúsítvány érvényessége
csr string igen* CSR request a tanúsítványhoz
voucher string nem Kedvezmény kupon
dv_auth_method string nem Domain tulajdonos hitelesítés módja. Megadható értékek Email, FILE vagy DNS. Výchozí hodnota je Email
owner_name string igen tanúsítvány tulajdonos vállalat neve
owner_street string igen tanúsítvány tulajdonos utca
owner_city string igen tanúsítvány tulajdonos város
owner_zip string igen tanúsítvány tulajdonos irányítószám
owner_country string igen kétszámjegyű kód a tanúsítvány tulajdonos országa alapján, pl: HU (ISO 3166-1 alpha-2)
owner_tel string igen telefonja a tanúsítvány tulajdonosnak +36.30554112554
auth_title string igen
auth_firstname string igen tanúsítvány tulajdonos keresztneve
auth_lastname string igen tanúsítvány tulajdonosának vezetékneve
auth_tel string igen telefonja a tanúsítvány tulajdonosnak +36.305541125544
auth_email string igen tanúsítvány tulajdonosnak +36.30554112554
tech_title string igen
tech_firstname string igen a tanúsítvány technikai személy keresztneve
tech_lastname string igen a tanúsítvány technikai személy vezetékneve
tech_email string igen a tanúsítvány technikai személy email címe
tech_tel string igen a tanúsítvány technikai személy telefon +36.554112554
invoice_name string igen tanúsítvány számlázási cím
invoice_street string igen tanúsítvány számlázási cím utca
invoice_city string igen tanúsítvány számlázási cím város
invoice_zip string igen tanúsítvány számlázási cím irányítószám
invoice_country string igen kétszemjegyű ország kód tanúsítvány számlázási cím, pl HU (ISO 3166-1 alpha-2)
invoice_email string igen tanúsítvány számlázási cím e-mail
invoice_ic string ne tanúsítvány számlázási cím irányítószám
invoice_dic string ne tanúsítvány számlázási cím adószám

* Záleží na typu certifikátu

Kimeneti paraméterek

A rendelési szám az SSLmarket adminisztrációjában használt belső megnevezés; használhatja a keresésnél.

Név Típus Leírás
order_id int Tanúsítvány száma

A funkció felsorolja az adott ügyfélszámlán lévő megrendeléseket.

GET /order/list
  • HTTP válasz állapotkód: 200
  • Válaszadat-formátum: application/json

Kimeneti paraméterek

Név Típus Leírás
orders array Megrendelés mező
.. order_id int Megrendelés szám
.. product_type string Termék típusa
.. product_code string Termék kódja
.. domain string annak a domainnek a neve, amelyre a tanúsítványt kiállítva lesz
.. dns_names array SAN-ba helyezett domainek helye
.. sans_order_count int A megrendelésbe helyezetett SAN-ok száma
.. years int Tanúsítvány érvényessége
.. inserted datetime A megrendelés leadásának dátuma és időpontja
.. published datetime A tanúsítvány kiállításának dátuma és időpontja
.. expired date A tanúsítvány lejárati dátuma

A funkció felsorolja egy adott tanúsítvány-megrendelés részleteit, amelyeket az ügyfélkezelésben is megtalálhat

GET /order/order_id/{{ORDER_ID}}
  • {{ORDER_ID}} - megrendelés száma
  • HTTP válasz állapotkód: 200
  • Válaszadat-formátum: application/json

Kimeneti paraméterek

Név Típus Leírás
product_type string Termék típusa
product_code string Termék kódja
domain string annak a domainnek a neve, amelyre a tanúsítvány ki lesz állítva
dns_names array SAN-ba helyezett domainek helye
sans_order_count int Megrendelésbe helyezett SAN-ok száma
years int A tanúsítvány érvényessége
csr string CSR request a tanúsítványhoz
owner_name string tanúsítvány tulajdonos neve
owner_street string tanúsítvány tulajdonos utca
owner_city string tanúsítvány tulajdonos város
owner_zip string tanúsítvány tulajdonos irányítószám
owner_country string kétszámjegyű kód a tanúsítvány tulajdonos országa alapján, pl: HU (ISO 3166-1 alpha-2)
owner_tel string tanúsítvány tulajdonos telefon +36.554112554
auth_title string
auth_firstname string tanúsítvány autorizációs személy keresztneve
auth_lastname string tanúsítvány autorizációs személy vezetékneve
auth_tel string tanúsítvány autorizációs személy telefon +36.554112554
auth_email string tanúsítvány autorizációs személy emailu
tech_title string
tech_firstname string tanúsítvány technikai személy keresztneve
tech_lastname string tanúsítvány technikai személy vezetékneve
tech_email string tanúsítvány technikai személy email
tech_tel string tanúsítvány technikai személy telefon +36.554112554
inserted datetime A megrendelés leadásának dátuma és időpontja
published datetime A tanúsítvány kiállításának dátuma és időpontja
expired date A tanúsítvány lejárati dátuma
dv_auth_method string Domain tulajndonos hitelesítésének módja. A válasz paraméter amennyiben product_type=ssl_certificate
dv_auth_content string Egyedezi azonosító érték a domain tulajdonosának hitelesítésére. A válasz paraméter amennyibenproduct_type=ssl_certificate a dv_auth_method=DNS nebo dv_auth_method=FILE

A funkció a tanúsítvány újrakiadására szolgál. Leggyakrabban a privát kulcs elvesztésekor kerül rá sor, és ingyenes. A tanúsítvány a reissue után ugyanazon paraméterek és dátumú lesz, mint az eredeti.

POST /certificate/order_id/{{ORDER_ID}}/reissue
  • {{ORDER_ID}} - megrendelés száma
  • Kérésadatformátuma: application/json
  • HTTP válaszállapot kód: 202

Bemeneti paraméterek

Név Kötelező Típus Leírás
csr igen string CSR request a tanúsítványhoz

A revokáló funkció arra szolgál hogy a tanúsítványt véglegesen elérvénytelenítse. A visszavonás a tanúsítvány kártérítés nélküli elvesztését jelenti, és a tanúsítvány titkos kulcsával való visszaélés (kompromitálódás) esetére szolgál.

PUT /certificate/order_id/{{ORDER_ID}}/revoke
  • Csak az alábbi termékekre érvényes DigiCert Client Premium Class 1 és Client Premium Class 2
  • {{ORDER_ID}} - megrendelés száma
  • HTTP válaszállapot kód: 202

A funkció arra szolgál hogy a választott formátumban tölthesse le a kiállított tanúsítvány, amely paramétert a kimenő {{FORMAT}} adja meg. A PEM a tanúsítvány szövegformátuma Base64-ben, míg P7B bináris formátum.

GET /certificate/order_id/{{ORDER_ID}}/format/{{FORMAT}}
  • {{ORDER_ID}} - megrendelés száma
  • {{FORMAT}} - tanúsítvány formátuma
    • pem_server - a végső (szerver, leaf) tanúsítványt adja vissza Base64 szöveges formátumban
    • pem_intermediate - visszaadja a közbenső tanúsítványt a végleges tanúsítvánnyal együtt. A tanúsítvány telepítéséhez szükséges. Ez a formátum alkalmas Apache, nginx és általában Linux szerverekhez.
    • p7b - A végső (szerver) tanúsítványt egy láncra érvényesként adja vissza (közbenső + tanúsítvány), ezeket eggyé alakítja P7B (PKCS # 7) bináris formátumban.
  • HTTP válaszállapot kód: 200
  • Válaszadat-formátum: text/plain
sslmarket mentőöv

Túl sok ez Önnek?

Írjon nekünk
info@sslmarket.hu
admin@zoner.hu
Kapcsolatfelvételi űrlap
Hívjon minket
+36 20 234 3883