Netim Direct
Updated on 20 September 2023

Reissue certificate

Description

PATCH https://rest.netim.com/1.0/ssl/{idSsl}/reissue/

Reissue a SSL certificate.

URL Parameters

  • {idSsl}
    SSL certificate ID (SSL-XXXX-XX).

Headers

  • Authorization string

    The Autorization header must start with “Bearer ” followed by the session ID.
    Example:”Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″

  • Content-type string

    Content type of the request

    Only “application/json” is accepted

Body

REQUIRED

  • CSRInfo object (StructCSR)
    StructCSR object containing information about the CSR.
  • validation string

    Validation method of the CSR

    • by email
      Provide for one email: “email:admin@yourdomain.com”
      Provide for several ones: “email:postmaster@yourdomain.com,webmaster@yourdomain.com”
    • by file,
      Provide “file”
    • by dns
      Provide “dns”

JSON example

{
	"CSR":{
		"Country":"country",
		"City":"city",
		"Region":"region",
		"Organisation":"organisation",
		"Department":"",
		"EmailAddress":"email",
		"CommonName":["www.website.com"],
		"AlternativeNames":[]
	},
	"validation":"email:admin@website.com"
}
  • Common names can’t be changed while reissuing a certificate.
  • CSRInfo must contain a StructCSR object which either contains the CSR and only the CSR if it is already generated or every other informations requested in purpose to generate one.
  • In the case of a validation by file, the validation parameter must be equal to “file”.
  • In the case of a validation by email, an email address must be provided for each different domains contained in the common names and alternative names properties of the StructCSR object.
  • Each email address must match one of the following addresses: admin@yourdomain.com, administrator@yourdomain.com, hostmaster@yourdomain.com, webmaster@yourdomain.com or postmaster@yourdomain.com.
  • If several addresses are provided, they must be separated by comas.
    For instance, if the CSR would contain yourdomain.com and yourdomain.fr, validation could be equal to “email:admin@yourdomain.com,postmaster@yourdomain.fr”;

Common language examples

<?php
 
	$ch = curl_init();
 
	$body = array(
		"CSR" => array(
			"Country" => "country",
			"City" => "city",
			"Region" => "region",
			"Organisation" => "organisation",
			"Department" => "",
			"EmailAddress" => "email",
			"CommonName" => array(
				"www.website.com",
			),
			"AlternativeNames" => array(),
		),
		"validation" => "email:admin@website.com",
    );
 
	curl_setopt($ch, CURLOPT_URL,"https://rest.netim.com/1.0/ssl/$idSsl/reissue/");
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
	curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
	curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
	curl_setopt($ch, CURlOPT_POSTFIELDS, json_encode($body));
 
 
	$result = json_decode(curl_exec ($ch), true);
	$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	curl_close ($ch);
 
import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
	public static void main(String args[]) throws Exception {
		String sessionID = "12345678";
		String idSSL = "SSL-XXXX-XX";
		String body = "{\"CSR\": {\"Country\":\"country\",\"City\":\"city\",\"Region\":\"region\",\"Organisation\":\"organisation\",\"Department\":\"\",\"EmailAddress\":\"email\",\"CommonName\":[\"www.website.com\"],\"AlternativeNames\":[]},\"validation\":\"email:admin@website.com\",}";
 
 
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://rest.netim.com/1.0/ssl/" + idSSL + "/reissue/"))
			.method("PATCH", HttpRequest.BodyPublishers.ofString(body))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Bearer " + sessionID)
			.build();
		HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
		String result = response.body().toString();
	}
}
#!/usr/bin/python3
 
import json
import requests
 
idSsl = 'SSL-XXXX-XX'
url = 'https://rest.netim.com/1.0/ssl/' + idSsl + '/reissue/'
 
sessionId = "1234567"
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
data = {
    "CSR": {
        "Country":"country",
        "City":"city",
        "Region":"region",
        "Organisation":"organisation",
        "Department":"",
        "EmailAddress":"email",
        "CommonName":["www.website.com"],
        "AlternativeNames":[]
    },
    "validation":"email:admin@website.com",
}
 
response = requests.patch(url, headers=headers, data=json.dumps(data))
curl -X PATCH https://api.netim.com/rest/1.0/ssl/SSL-XXXX-XX/reissue/ \
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'Content-type: application/json' \
-d '{"CSR": {"Country":"country","City":"city","Region":"region","Organisation":"organisation","Department":"","EmailAddress":"email","CommonName":["www.website.com"],"AlternativeNames":[]},"validation":"email:admin@website.com",}'