API Reference

CSR Validation Service

Check CSR
Purpose
The Check CSR function allows you to check the CSR validity. Different products have different CSR requirements, so it is always recommended to check the CSR with this function. This makes order processing that much more robust.

URL

  • LIVE URL:
https://api.thesslstore.com/rest/csr
  • SANDBOX URL:
https://sandbox-wbapi.thesslstore.com/rest/csr

HTTP VERB
POST

PARAMETERS
JSON :

{
	"AuthRequest":{
		"PartnerCode":"YOURPARTNERCODE",
		"AuthToken":"YOURAUTHTOKEN",
		"ReplayToken":"",
		"UserAgent":""
	},
	"ProductCode":"PRODUCTCODE",
	"CSR":"YOURCSR"
}

XML

<CSRRequest>
<AuthRequest>
<PartnerCode>YOURPARTNERCODE</PartnerCode>
<AuthToken>YOURAUTHTOKEN</AuthToken>
<ReplayToken></ReplayToken>
<UserAgent></UserAgent>
</AuthRequest>
<ProductCode>PRODUCTCODE</ProductCode>
<CSR>YOURCSR</CSR>
</CSRRequest>

RESPONSE
JSON :

{
	"AuthResponse":{
		"isError":false,
		"Message":[""],
		"Timestamp":"Response Generated on",
		"ReplayToken":"TOKEN-FROM-YOUR-REQUEST",
		"InvokingPartnerCode":"YOURPARTNERCODE"
	},
	"DominName":"domainname",
	"DNSNames":["alternate dns names"],
	"Country":"COUNTRY CODE",
	"Email":"Email address from CSR if available",
	"Locality":"Locality",
	"Organization":"Organization from the CSR",
	"OrganisationUnit":"OU from CSR",
	"State":"String content",
	"hasBadExtensions":true,
	"isValidDomainName":true,
	"isWildcardCSR":true
}

XML:

<CSRResponse>
<AuthResponse>
<isError>false</isError>
<Message>
<string>SUCCESS</string>
<string>MORE LINES</string>
</Message>
<Timestamp>Response generated on UTC</Timestamp>
<ReplayToken>TOKEN-FROM-YOUR-REQUEST</ReplayToken>
<InvokingPartnerCode>String content</InvokingPartnerCode>
</AuthResponse>
<DominName>String content</DominName>
<DNSNames>
<string>Alternate names</string>
<string> Alternate names</string>
</DNSNames>
<Country>String content</Country>
<Email>String content</Email>
<Locality>String content</Locality>
<Organization>String content</Organization>
<OrganisationUnit>String content</OrganisationUnit>
<State>String content</State>
<hasBadExtensions>true</hasBadExtensions>
<isValidDomainName>true</isValidDomainName>
<isWildcardCSR>true</isWildcardCSR>
</CSRResponse>

 

NAME FROM Type Description
AuthRequest.AuthToken Request String This is an alpha-numeric token code provided to you by thesslstore.com. It is required in all requests.
*Required for this request
AuthRequest.PartnerCode Request String This is an alpha-numeric code provided to you by thesslstore.com. It is required in all requests.
*Required for this request
AuthRequest.ReplayToken Request String This is an alpha-numeric code provided by you in order request and thesslstore.com sent back in request.
AuthRequest.UserAgent Request String Browser’s user agent value provided by you for specific order.
CSRRequest.CSR Request String Certificate Signing Request (Base-64 encoded, with or without the —–BEGIN xxxxx—– and —–END xxxxx—– header and footer)
*Required for this request
CSRRequest.ProductCode Request String A code for the product that a particular request relates to. Note that a partner must have a valid contract for a product code for it to be valid in a request. Also, a product code must be valid for the context of the request.
*Required for this request
AuthResponse.InvokingPartnerCode Response String This is an alpha-numeric code provided to you by thesslstore.com.
AuthResponse.isError Response Boolean Return true if any error occurred during Order processing.
AuthResponse.ReplayToken Response String The value of the ReplayToken which is provided by you in Order request.
AuthResponse.Timestamp Response String A date timestamp used in a variety of contexts. Note that the XML format is: YYYY-DD-MMTHH:MM:SS:000Z (for example, 2001-01-01T24:00:00:000Z is for Jan 1, 2001 at midnight).
CSRResponse.Country Response String Country from CSR
CSRResponse.DominName Response String This is the Domain name which is sent by thesslstore.com in response
CSRResponse.Email Response String Email From CSR
CSRResponse.hasBadExtensions Response Boolean States that CSR has Bad Extensions or not
CSRResponse.isValidDomainName Response Boolean Response that is it valid domain name or not
CSRResponse.isWildcardCSR Response Boolean Tells that is this CSR is for wildcard
CSRResponse.Locality Response String Locality from the CSR
CSRResponse.OrganisationUnit Response String Organization Unit From CSR
CSRResponse.Organization Response String Organization From CSR
CSRResponse.State Response String State From CSR