メインコンテンツまでスキップ

2.1 データの検証

2.1.1 インターフェースの説明​

テスト環境
本番環境https://portal.racent.com/ssl/validate
リクエスト方式POST
content-typemultipart/form-data
説明このインターフェースは、お客様が送信するすべての注文データを検証するために使用されます。注文処理をスムーズに行うため、注文インターフェースを呼び出す前に本インターフェースを呼び出してください。この検証では、アカウント情報の確認と注文情報に誤りがないことを確認し、該当するエラーコードを返します（付録3.1を参照）。

2.1.2 パラメータ定義​

パラメータ名パラメータの型必須説明
api_tokenStringYユーザーtoken。tokenの取得についてはRacentテクニカルサポートまでお問い合わせください
productCodeStringY製品コード。製品コードの取得については（2.7を参照）
yearsIntY購入年数（現在は1、2、3、4、5にのみ対応）。具体的な製品によって異なります。
refIdStringNお客様が提供する一意の注文番号
verificationPicFileN予備検証資料。組織検証に使用します。形式は.jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdfに対応し、コンテンツサイズは2M以下とします。
domainVerificationPicFileNドメイン検証方式がVERIFY_DOCUMENTの場合、この項目はYとなります。ドメイン管理権限の検証（DCV）に使用します（現在はCFCAのみ対応）。
paramsStringY注文情報（json文字列）、具体的な説明は以下の通りです
csrStringNパラメータが空の場合、CSRが生成され、秘密鍵が保存されます。
privateKeyStringN秘密鍵。
serverStringNサーバー。SSL証明書にのみ関連します。SSL証明書のパラメータはY、その他の種類の製品のパラメータはNです。このパラメータが不要な場合は、デフォルトで「other」を設定してください。
uniqueValueStringNSectigo製品にのみ関連します。販売店が独自に検証値を生成するための1～20文字（a-z A-Z 0-9）の文字列です。
dcvMethodStringN申請するドメインの検証方式を一括設定します。
以下のいずれかの方式を指定する必要があります：
EMAIL（メール検証）
HTTP_CSR_HASH（ファイル検証）
CNAME_CSR_HASH（DNS検証）
HTTPS_CSR_HASH（httpsファイル検証）
VERIFY_DOCUMENT（ドメイン証明書による証明、CFCAのみサポート）
CFCAの場合、この項目はYです
domainInfoStringNドメイン情報、SSL証明書にのみ関連します。SSL証明書のパラメータはY、その他のタイプのパラメータはNです。
例：
[
{ "dcvEmail": "admin@xxx.com",
"dcvMethod": "EMAIL",
"domainName": "www.xxx.com"
},
{
"dcvEmail": "admin@aaa.com",
"dcvMethod": "EMAIL",
"domainName": "aaa.com"
},
"dcvEmail": "admin@racent.com",
"dcvMethod": "EMAIL",
"domainName": "racent.com"
}
]
具体的な説明は以下の通りです：
dcvMethodStringNドメイン検証方式。
以下の4つの方式のいずれかである必要があります：
EMAIL(メール検証)
HTTP_CSR_HASH(ファイル検証)
CNAME_CSR_HASH(DNS検証)
HTTPS_CSR_HASH(httpsファイル検証)
上位のdcvMethodが存在しない場合、この項目はYとなります。
上位のdcvMethodが存在し、この項目も存在する場合は、上位のdcvMethodが優先して使用されます。
dcvEmailStringNドメイン検証用メールアドレス。
この項目がNの場合のデフォルトは以下の通りです
racent.com : admin@racent.com
www.racent.com : admin@racent.com
*.racent.com : admin@racent.com
domainNameStringNドメイン名
organizationInfoStringN企業情報。企業検証が必要な製品を注文する場合、このパラメータはYです。例は以下の通りです：
{
"organizationCity": "上海",
"organizationName": "某公司",
"organizationMobile": "18111111111",
"organizationAddress": "上海市路",
"organizationCountry": "CN",
"organizationPostCode": "401320"
}"
organizationCityStringN会社の所在都市です。
organizationNameStringN会社名です。
organizationMobileStringN会社の電話番号です。
organizationAddressStringN会社住所。
organizationCountryStringN会社所在国（ISO 3166-1規格の2文字コード）。
organizationPostCodeStringN会社所在地の郵便番号。
organizationRegNumberStringN会社証明書番号。CFCAの場合はこの項目がYとなります。
idTypeStringN会社証明書の種類。CFCAの場合はこの項目がYとなります。
値は以下の通りです：
TYDMZ：統一社会信用コード
OTHERS：その他
AdministratorstringY管理者情報、連絡先。コード署名、メール署名、ドキュメント署名を申請する場合、このパラメータは申請情報として使用されます。また、csrがNの場合、この情報はcsrの生成情報として使用されます。
{
"job": "総経理室",
"city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringY管理者の役職。
cityStringY管理者の所在都市。
emailStringY管理者のメールアドレス。
stateStringY管理者が所在する省または州。
mobileStringY管理者の連絡先。
addressStringY管理者の連絡先住所。
countryStringY管理者の所在国（ISO 3166-1規格の2文字コード）。
lastNameStringY管理者の姓。
postCodeStringY管理者の所在地の郵便番号。
firstNameStringY管理者の名前。
organationStringY管理者の会社名。
idTypeStringN証明書の種類。CFCAの場合、この項目はYです。
値は以下の通りです：
SFZ：居民身分証
HZ：パスポート
idNumberStringN証明書番号。CFCAの場合、この項目はYです。
financestringSSL証明書にのみ関連します。
財務担当者情報。管理者情報と同一でも構いません。注文する製品がdvタイプでない場合、このパラメータはYです。
{
"job": "財務部",
"city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringN経理担当者の役職です。
cityStringN経理担当者が所在する都市です。
emailStringN経理担当者のメールアドレスです。
stateStringN財務担当者が所在する省または州です。
mobileStringN財務担当者の連絡先です。
addressStringN財務担当者の連絡先住所です。
countryStringN財務担当者が所在する国（ISO 3166-1規格の2文字コード）。
lastNameStringN財務担当者の姓。
postCodeStringN財務担当者が所在する地域の郵便番号。
firstNameStringN経理担当者の名前。
organationStringN経理担当者の所属会社。
idTypeStringN証明書類の種類。CFCAの場合はY。
値は以下の通り：
SFZ：住民身分証
HZ：パスポート
idNumberStringN証明書番号。CFCAの場合、この項目はYとなります。
techstringNSSL証明書にのみ関連します。
技術担当者情報。注文する製品がdvタイプでない場合、このパラメータはYとなります。
{
"job": "技術部","city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringN技術担当者の役職。
cityStringN技術者の所在都市。
emailStringN技術者のメールアドレス。
stateStringN技術者の所在する省または州。
mobileStringN技術担当者の連絡先。
addressStringN技術担当者の連絡先住所。
countryStringN技術担当者の所在国（ISO 3166-1規格の2文字コード）。
lastNameStringN技術担当者の姓。
postCodeStringN技術担当者の所在地の郵便番号。
firstNameStringN技術担当者の名前。
organationStringN技術者が所属する会社。
idTypeStringN身分証明書の種類。CFCAの場合、この項目はYです。
値は以下の通りです：
SFZ：身分証
HZ：パスポート
idNumberStringN身分証明書番号。CFCAの場合、この項目はYです。

戻り値​

パラメータ名パラメータの型必填説明
codeIntY戻りステータス。詳しくは付録3.1を参照してください
errorsObject or StringN戻りステータスがエラーの場合のエラーメッセージ。

2.1.3 リクエスト例​

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}

に最終更新