GETPOST

v1.0.0stable

Kiểm tra trạng thái chứng chỉ

Kiểm tra trạng thái chứng chỉ bằng xác thực token và KID chứng chỉ hoặc UDID thiết bị

GET | POST/api/device/certcheck

Xác thực:API Key

Giới hạn:30/phút

Tham số yêu cầu

Tất cả tham số có thể truyền qua Query hoặc Body

Tham số	Loại	Bắt buộc	Mô tả
`token`	string	Bắt buộc	Token API người dùng Ví dụ: your_api_token_here
`kid`	string	Tùy chọn	KID chứng chỉ. Cung cấp kid hoặc udid Ví dụ: ABC123XYZ
`udid`	string	Tùy chọn	UDID thiết bị. Cung cấp kid hoặc udid Ví dụ: 00008030-001234567890002E

Phản hồi

Tham số	Loại	Bắt buộc	Mô tả
`code`	number	Bắt buộc	Mã trạng thái: 1=thành công, khác=thất bại Ví dụ: 1
`msg`	string	Bắt buộc	Tin nhắn phản hồi Ví dụ: 证书状态正常
`time`	number	Bắt buộc	Mốc thời gian máy chủ (giây Unix) Ví dụ: 1769675945
`data`	object	Bắt buộc	Dữ liệu phản hồi
`data.status`	string	Bắt buộc	Trạng thái chứng chỉ: normal/expired/revoked/banned/dropped/unknown Ví dụ: normal
`data.status_code`	number	Bắt buộc	Mã trạng thái: 205=bình thường, 203=hết hạn, 204=thu hồi, 207=cấm, 206=rơi, 208=không rõ Ví dụ: 205
`data.status_text`	string	Bắt buộc	Văn bản trạng thái Ví dụ: 正常
`data.details`	string	Bắt buộc	Chi tiết Ví dụ: 证书有效，剩余 180 天过期
`data.check_method`	string	Bắt buộc	Phương pháp kiểm tra: Trực tuyến / Cục bộ Ví dụ: 在线检测
`data.can_detect_revoke`	boolean	Bắt buộc	Có thể phát hiện thu hồi: true=kiểm tra trực tuyến khả dụng, false=chỉ kiểm tra cục bộ Ví dụ: true
`data.revoked_at`	string	Bắt buộc	Thời gian thu hồi (chỉ cho thu hồi/cấm) Ví dụ: 2026-01-15 10:30:00
`data.expires_at`	string	Bắt buộc	Thời gian hết hạn chứng chỉ Ví dụ: 2027-01-28 15:30:00
`data.remaining_days`	number	Bắt buộc	Số ngày còn hiệu lực Ví dụ: 180
`data.cert_info`	object	Bắt buộc	Thông tin chứng chỉ
`data.cert_info.common_name`	string	Bắt buộc	Tên chung chứng chỉ Ví dụ: Apple Development: John Doe (XXXXXXXXXX)
`data.cert_info.valid_from`	string	Bắt buộc	Thời gian bắt đầu hiệu lực Ví dụ: 2026-01-28 15:30:00
`data.cert_info.valid_to`	string	Bắt buộc	Thời gian hết hạn Ví dụ: 2027-01-28 15:30:00
`data.device`	object	Bắt buộc	Thông tin thiết bị
`ip`	string	Bắt buộc	Địa chỉ IP người yêu cầu Ví dụ: 192.168.1.100
`ysucc`	string	Bắt buộc	Cờ thành công, trả về "Ysucc" khi thành công Ví dụ: Ysucc

Ví dụ phản hồi

{

"code":1,

"msg":"Trạng thái chứng chỉ bình thường",

"time":1769675945,

"data":

{

"status":"normal",

"status_code":205,

"status_text":"正常",

"details":"在线验证通过，证书有效，剩余 180 天过期",

"check_method":"在线检测",

"can_detect_revoke":true,

"revoked_at":"",

"expires_at":"2027-01-28 15:30:00",

"remaining_days":180,

"cert_info":

{

"common_name":"Apple Development: John Doe (XXXXXXXXXX)",

"valid_from":"2026-01-28 15:30:00",

"valid_to":"2027-01-28 15:30:00",

"issuer":"Apple Inc.",

"country":"CN"

}

"device":

{

"id":12345,

"kid":"ABC123XYZ",

"udid":"00008030-001234567890002E",

"pname":"MyApp Development",

"model":"iPhone 15 Pro",

"shtype":1,

"zt":"normal"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Chứng chỉ đã rơi (Trực tuyến)

Kiểm tra trực tuyến phát hiện chứng chỉ đã rơi

Chứng chỉ đã rơi (Trực tuyến)

{

"code":1,

"msg":"Chứng chỉ đã rơi",

"time":1769675945,

"data":

{

"status":"dropped",

"status_code":206,

"status_text":"掉签",

"details":"证书已被吊销",

"check_method":"在线检测",

"can_detect_revoke":true,

"device":

{

"id":12345,

"kid":"ABC123XYZ",

"udid":"00008030-001234567890002E",

"pname":"MyApp Development",

"zt":"hidden"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Tài khoản bị cấm

Tài khoản nhà phát triển đã bị Apple cấm

Tài khoản bị cấm

{

"code":1,

"msg":"Tài khoản nhà phát triển đã bị cấm",

"time":1769675945,

"data":

{

"status":"banned",

"status_code":207,

"status_text":"账号封禁",

"details":"Apple 封禁了该开发者账号",

"check_method":"在线检测",

"can_detect_revoke":true,

"revoked_at":"2026-01-15 10:30:00",

"device":

{

"id":12345,

"zt":"hidden"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Kiểm tra cục bộ (Trực tuyến không khả dụng)

Kiểm tra trực tuyến không khả dụng, chuyển về kiểm tra cục bộ

Kiểm tra cục bộ (Trực tuyến không khả dụng)

{

"code":1,

"msg":"Hiệu lực chứng chỉ bình thường (chưa xác minh trạng thái thu hồi)",

"time":1769675945,

"data":

{

"status":"normal",

"status_code":205,

"status_text":"正常",

"details":"本地检测：证书在有效期内，剩余 180 天过期。注意：在线检测不可用，无法确认证书是否被吊销",

"check_method":"本地检测（网络不可用）",

"can_detect_revoke":false,

"expires_at":"2027-01-28 15:30:00",

"remaining_days":180,

"device":

{

"id":12345,

"pname":"MyApp Development",

"zt":"normal"

}

"ip":"192.168.1.100",

"ysucc":"Ysucc"

}

Tìm thấy nhiều chứng chỉ

Có nhiều chứng chỉ cho cùng UDID, sử dụng kid để chỉ định

Tìm thấy nhiều chứng chỉ

{

"code":103,

"msg":"Tìm thấy nhiều thiết bị, vui lòng chỉ định ID chứng chỉ cụ thể",

"time":1769675945,

"data":

{

"count":3,

"devices":

[

{

"id":12345,

"kid":"ABC123",

"pname":"App A",

"shtype":1

}

{

"id":12346,

"kid":"DEF456",

"pname":"App B",

"shtype":2

}

{

"id":12347,

"kid":"GHI789",

"pname":"App C",

"shtype":1

}

]

}

"ip":"192.168.1.100",

"yno":"Yno"

}

Mã lỗi

Mã lỗi8 được định nghĩa

12

Token không được để trống

Thiếu tham số Token

10

Token không hợp lệ

Token không hợp lệ hoặc đã hết hạn

20

Vui lòng cung cấp kid hoặc udid

Thiếu kid hoặc udid

Ngôn ngữ phản hồi

Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.

Header đề xuất

X-Lang: vi

Ngôn ngữ được hỗ trợ

zh, en, zh-TW, vi, ar

Bạn cũng có thể dùng Accept-Language; X-Lang có ưu tiên cao hơn. Ngôn ngữ không được hỗ trợ sẽ chuyển sang tiếng Anh.

Ví dụ mã

curl -X GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E" \
  -H "X-Lang: vi"

Lưu ý

Hỗ trợ cả GET và POST
Cung cấp ít nhất một trong: kid hoặc udid
Nếu có nhiều chứng chỉ cho cùng UDID, sẽ trả về thông báo
Kiểm tra trực tuyến: Phát hiện hiệu lực + trạng thái thu hồi, cần mạng
Kiểm tra cục bộ: Chỉ kiểm tra thời hạn hiệu lực, không phát hiện thu hồi
Chuyển về kiểm tra cục bộ khi kiểm tra trực tuyến không khả dụng
Trạng thái thiết bị tự động cập nhật thành hidden khi phát hiện thu hồi/cấm
Tránh gọi thường xuyên để ngăn chặn giới hạn từ Apple

Thử trong Console

Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.

https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002EĐã khóa vào trang này

tokenstringBắt buộc

Token API người dùng

kidstring

KID chứng chỉ. Cung cấp kid hoặc udid

udidstring

UDID thiết bị. Cung cấp kid hoặc udid