Отозвать сертификат

PUT
https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke

Все запросы на отзыв должны быть утверждены администратором, прежде чем DigiCert отзовет сертификат. Этот шаг утверждения является обязательным, его нельзя пропустить.

Используйте эту конечную точку для отправки запроса на отзыв одного сертификата в заказе.

Если вы хотите отправить запрос на отзыв заказа полностью, воспользуйтесь конечной точкой Отзыв сертификатов, указанных в заказе.

Сертификаты с находящимся на рассмотрении заказом на повторный выпуск отозвать нельзя. Чтобы отозвать сертификат с находящимся на рассмотрении заказом на повторный выпуск, либо отзовите запрос на повторный выпуск, либо отмените сертификат после повторного выпуска.

Что происходит, если я отзываю сертификат из заказа, содержащего только один сертификат?

Если вы отзываете сертификат из заказа, содержащего только один сертификат:

  • Заказ остается активным
  • Вы можете перевыпустить сертификат по данному заказу
  • Возврат средств за отозванный сертификат по заказу не предусмотрен

Если вы не планируете перевыпуск сертификата для заказа, воспользуйтесь конечной точкой Отозвать сертификаты заказа, чтобы отправить запрос на отзыв заказа.

cURL
curl -X PUT \
  'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "comments": "I no longer need this cert."
}'
Python
import requests

url = "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"

payload = "{\n  \"comments\": \"I no longer need this cert.\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("PUT", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"

	payload := strings.NewReader("{\n  \"comments\": \"I no longer need this cert.\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
NodeJS
var request = require("request");

var options = { method: 'PUT',
  url: 'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { comments: 'I no longer need this cert.' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 Created
{
  "id": 1,
  "date": "2016-02-10T17:06:15+00:00",
  "type": "revoke",
  "status": "pending",
  "requester": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "comments": "I no longer need this cert."
}

Параметры запроса

Имя Обязательный/Необязательный Тип Описание
comments необязательный string Сообщение о запросе на отзыв.

Параметры ответного сообщения

Имя Тип Описание
id int Идентификатор запроса.
date string Отметка времени предоставления запроса.
Формат: Часовой пояс UTC (универсальное глобальное время) и дата в формате ISO 8601
type string Тип запроса.
Допустимые значения: revoke
status string Статус запроса на отзыв.
Допустимые значения: submitted, pending, approved, rejected
requester object Подробные сведения о пользователе, разместившем запрос.
См. Структуры — Объект подробных сведений о пользователе.
comments string Сообщение о запросе на отзыв.