调用CheckCertificate接口,查询iOS证书过期时间及当前证书状态。

  • 如果返回的ExipreTime大于当前时间戳,并不代表证书一定可用,还需检查Status是否为OK。
  • REVOKED来源于APNs服务器,如果证书处于REVOKED状态时,则对应环境中至少有一条推向APNs的推送失败。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CheckCertificate

系统规定参数。取值:CheckCertificate。

AppKey Long 23267207

AppKey信息。

返回数据

名称 类型 示例值 描述
Android Boolean false

判断AppKey代表的是否是Android app:

  • true
  • false
DevelopmentCertInfo Struct

访问开发环境/沙箱环境的证书信息。

ExipreTime Long 1470024000000

证书过期时间。

Status String EXPIRED

证书状态,取值:

  • EXPIRED:已过期
  • NOT_CONFIGURED:未配置
  • NO_PASSWORD:未配置密码
  • OK:正常
  • REVOKED:已撤销
IOS Boolean true

判断AppKey代表的是否是iOS app:

  • true
  • false
ProductionCertInfo Struct

访问生产环境的证书信息。

ExipreTime Long 1764561600000

证书过期时间。

Status String OK

证书状态,取值:

  • EXPIRED:已过期
  • NOT_CONFIGURED:未配置
  • NO_PASSWORD:未配置密码
  • OK:正常
  • REVOKED:已撤销
RequestId String 9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CheckCertificate
&AppKey=23267207
&<公共请求参数>

正常返回示例

JSON格式

{"RequestId":"9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC","DevelopmentCertInfo":{"Status":"EXPIRED","ExipreTime":"1470024000"},"IOS":"true","ProductionCertInfo":{"Status":"OK","ExipreTime":"1764561600000"},"Android":"false"}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid%s.NotFound The specified %s is not found. 参数错误,未找到。
400 AccountDisabled Your account is not enabled. 功能未启用。
400 PermissionDenied The specified AppKey is not authorized. 您没有访问该app的权限,请您检查Appkey参数是否属于该账户。
500 InternalError The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket. 服务端错误,建议重试,仍然失败则提工单

访问错误中心查看更多错误码。