30strumenti
Il tuo agente IA entra nella tua zona DNS, non nella tua fattura.
Scopri la MCP Suite
TLS certificates
v1.6.2
Download OpenAPI
Complete staged TLS certificate order
Complete an action-required TLS certificate order by binding it to an existing usable DigiCert organization and submitting the provider order.
POST
/tls/certificate/{certificate_id}/complete
TLSCertificatesByID

Authentication

x-api-keyapplication/json

Parameters

Name
Type
Format
Required
Description
certificate_id
path
string
-
Required
Public TLS certificate ID

Request body

application/jsonRequired
TLS certificate completion payload
tlsCertificateCompleteRequest
tlsCertificateCompleteRequest
{
  "org_id": "hdl_7K9QW3M2ZT8HJ"
}

Fields

Name
Type
Format
Required
Description
org_id
string
-
Required
Public TLS organization ID

Request example

POST
curl --request POST \
  --url 'https://api.regfish.com/tls/certificate/7K9QW3M2ZT8HJ/complete' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
  "org_id": "hdl_7K9QW3M2ZT8HJ"
}'

Responses

200
TLS certificate order completed
application/jsontlsCertificateResponse
Response example 200
{
  "success": true,
  "code": 0,
  "response": {
    "id": "7K9QW3M2ZT8HJ",
    "status": "pending",
    "common_name": "www.example.com",
    "product": "SecureSite",
    "provider": "digicert",
    "dns_names": [
      "www.example.com"
    ],
    "order_state": "PENDING",
    "action_required": false,
    "pending_reason": "validation_pending",
    "pending_message": "The TLS certificate order is waiting for domain validation.",
    "completion_url": "",
    "organization_id": "hdl_7K9QW3M2ZT8HJ",
    "validity_days": 199,
    "certificate_pem_available": false,
    "validation": {
      "method": "dns-cname-token",
      "dns_records": [
        {
          "name": "_dnsauth.example.com.",
          "type": "CNAME",
          "value": "0123456789abcdef.dcv.digicert.com."
        }
      ]
    }
  }
}
400
Invalid request payload or stored CSR
application/jsonError
Response example 400
{
  "success": false,
  "message": "Invalid request payload or stored CSR",
  "error": "Invalid request payload or stored CSR"
}
401
Unauthorized
application/jsonError
Response example 401
{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}
404
TLS certificate or referenced renewal source not found
application/jsonError
Response example 404
{
  "success": false,
  "message": "TLS certificate or referenced renewal source not found",
  "error": "TLS certificate or referenced renewal source not found"
}
409
The TLS certificate order cannot be completed in its current state
application/jsonError
Response example 409
{
  "success": false,
  "message": "The TLS certificate order cannot be completed in its current state",
  "error": "The TLS certificate order cannot be completed in its current state"
}
500
Unexpected error
application/jsonError
Response example 500
{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}
502
Upstream TLS provider error
application/jsonError
Response example 502
{
  "success": false,
  "message": "Upstream TLS provider error",
  "error": "Upstream TLS provider error"
}
Community

Diventa parte della comunità

L'API DNS regfish è un'ottima soluzione per gli sviluppatori che desiderano automatizzare domini e zone DNS. Entra a far parte della community e beneficia dell'automazione DNS. L'API DNS è disponibile gratuitamente per ogni cliente regfish.