Verify Certificate
POST /api/v1/productions/{productionId}/verify-certificate: validate a stored JWT compliance certificate.
A 200 does not mean the certificate is valid. Read the valid field. This endpoint returns 200 for good and bad certificates alike, and reason explains a failure. The one exception is production_id_mismatch, which arrives as 400: the certificate verified, but it belongs to a different production than the one in the URL.
Authorization
BearerAuth Partner API key from partner.easy2257.com/api-keys. Only ez_live_ keys are accepted. A key beginning with ez_test_ is rejected with 403 and code TEST_MODE_UNAVAILABLE before any handler runs: there is no sandbox, and every handler writes production records, provisions real users, and sends real email. New partner accounts start with a test key, so create a live key before your first call.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The RS256 JWT compliance certificate Easy2257 issued, as delivered in the production.documented webhook.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://easy2257.com/api/v1/productions/cmd3p8w1k0002qz8h9j4r7v5s/verify-certificate" \ -H "Content-Type: application/json" \ -d '{ "certificate": "eyJhbGciOiJSUzI1NiIsImtpZCI6ImV6MjI1Ny1hZDg4ODUyYyJ9..." }'{
"valid": true,
"productionId": "cmd3p8w1k0002qz8h9j4r7v5s",
"issuedAt": "2019-08-24T14:15:22Z",
"expiresAt": "2019-08-24T14:15:22Z",
"currentStatus": "documented",
"reason": "certificate_revoked"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}{
"error": "Too many requests. Please slow down.",
"retryAfter": 14,
"limit": 60,
"remaining": 0,
"reset": 1714000060000
}{
"error": "email, externalUserId, and callbackUrl are required",
"code": "missing_parameter",
"field": "contentType"
}