Домены / Сертификаты

Получение SSL/TLS-сертификатов доменов через REST API. Сертификаты выпускаются платформой автоматически (Let's Encrypt). Все методы требуют токен аутентификации.

GET /v1/domain/:domainId/certificates

Возвращает все SSL/TLS-сертификаты домена — массив объектов CertificateResponse. Для каждого сертификата в ответе присутствуют имя, тип (user или system), статус, флаг enable, дата окончания действия validUntil, издатель, UUID домена и даты создания и обновления. Сертификаты выпускаются платформой автоматически: в примере ответа издателем выступает Let's Encrypt.

Параметры:

Ответ:

[
    {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "My Certificate",
        "type": "user",
        "status": "ready",
        "enable": true,
        "validUntil": "2025-01-15T10:30:00+00:00",
        "issuer": "Let's Encrypt",
        "domainId": "660e8400-e29b-41d4-a716-446655440001",
        "createdAt": "2024-01-15T10:30:00+00:00",
        "updatedAt": "2024-01-15T10:30:00+00:00"
    }
]

Ошибки:

• 404 Not Found — Домен не найден

GET /v1/domain/certificate/:certificateId

Возвращает один сертификат по его UUID в виде объекта CertificateResponse. Ответ содержит имя, тип (user или system), статус и флаг enable, дату окончания действия validUntil, издателя, UUID связанного домена, а также даты создания и обновления сертификата.

Параметры:

Ответ:

{
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "My Certificate",
    "type": "user",
    "status": "ready",
    "enable": true,
    "validUntil": "2025-01-15T10:30:00+00:00",
    "issuer": "Let's Encrypt",
    "domainId": "660e8400-e29b-41d4-a716-446655440001",
    "createdAt": "2024-01-15T10:30:00+00:00",
    "updatedAt": "2024-01-15T10:30:00+00:00"
}

Ошибки:

• 404 Not Found — Сертификат не найден