TL;DR

Turing Space vừa công bố Turing Verify API v1 đã sẵn sàng tại https://api.verify.turingcerts.com. Slogan: “Auto verify anything before you trust.” 6 endpoint core, 6 verdict chuẩn, webhook ký HMAC-SHA256, SDK Python/Node, OpenAPI 3.1 và cả một cửa /mcp/docs riêng cho AI agent. Khác biệt chính so với các API KYC truyền thống: kết quả VERIFIED không chỉ là OCR + forensic — nó truy được về chuỗi tin cậy của issuer nhờ W3C Verifiable Credentials và DID ghi trên blockchain IOTA/Shimmer.

What's new

Trước đây Turing Space nổi tiếng với mảng phát hành credential (Turing Certs — đã issue 6 triệu credential, 550+ issuer, 40+ cơ quan chính phủ tính đến tháng 3/2025). Lần này họ mở mảng consume: bất kỳ dev nào cũng có thể lấy bearer token tv_live_sk_... hoặc tv_test_sk_... và verify một file PDF, URL hoặc base64 chỉ bằng một POST /v1/verifications.

Announcement đến từ Jeff Hu (@thejeffhu), tag @turing_certs, hashtag #TuringVerify. Tham chiếu đầy đủ tại api.verify.turingcerts.com/v1/docs/reference.

Why it matters

Mọi flow onboarding, KYC, hiring, admission hiện nay đều đang chờ một con người nhìn vào file PDF rồi gõ “OK”. Đó là chi phí lớn — và trong kỷ nguyên AI sinh được cả bằng cấp giả trong 30 giây, nó còn là rủi ro. Một API verify có tính cryptographic provenance (không phải chỉ “ảnh nhìn có thật không”) cho phép hệ thống của bạn từ chối niềm tin mặc định, và chỉ trust khi issuer ký xác nhận được trên chuỗi.

Endpoint /mcp/docs còn gợi ý một hướng dùng mới: các AI agent có thể gọi Turing Verify như một tool trước khi chấp nhận bất kỳ credential do user upload — đúng đồ dành cho agent-native workflows.

Technical facts

Những gì dev cần biết khi đọc doc:

  • Base URL: https://api.verify.turingcerts.com — HTTPS + JSON, timestamp RFC-3339 UTC.
  • Auth: bearer token. 2 loại — tv_live_sk_* (tính credit) và tv_test_sk_* (zero-credit, deterministic, dùng cho CI).
  • 6 endpoint core: POST /v1/verifications, GET /v1/verifications/{id}, GET /v1/verifications, POST /v1/verifications/batch (≤1000 docs, chỉ Business), GET /v1/account, GET /v1/account/usage, cộng thêm POST|GET /v1/webhooks.
  • Input: multipart file, URL từ xa, hoặc base64 — chọn cách nào cũng được.
  • Credits: standard verify = 1 credit, deep verify = 5 credit, test mode = 0.
  • Rate limit token-bucket: Pro 20 burst / 600 rpm sustained, Business 40 burst / 3000 rpm sustained. Header chuẩn X-RateLimit-Limit/Remaining/Reset.
  • Webhooks: HMAC-SHA256 ký, format t=<timestamp>,v1=<hex_digest>, retry 9 lần trong ~45 giờ.
  • SDK: Python turingverify, Node/TS @turingverify/sdk — auto-retry, auto idempotency key, signature verifier sẵn.
  • OpenAPI 3.1 tại /v1/openapi.json, raw markdown tại /v1/docs.md, MCP docs tại /mcp/docs.

6 verdict values

VerdictNghĩa
VERIFIEDPass forensic + chuỗi tin cậy
REJECTEDDấu hiệu gian lận rõ
SUSPECTBất thường, cần điều tra
NOT_CREDENTIALFile không phải credential verify được
MANUAL_REVIEWCần người duyệt
VERIFIED SAMPLETest mode placeholder

Error envelope có code, message, request_id, docs_url. Code thường gặp: authentication_required (401), invalid_api_key (401), insufficient_scope (403), rate_limited (429), internal_error (500).

Comparison

So với Onfido, Persona, Jumio, Veriff — những API verify thông dụng — Turing Verify khác biệt ở nền tảng tin cậy, không phải ở UX:

Tiêu chíKYC API truyền thốngTuring Verify
Cơ chếOCR + forensic + livenessW3C VC + DID + forensic
Chuỗi tin cậyTin nhà phát hành OCRKý số từ issuer, on-chain
Lưu trữCentralizedIOTA/Shimmer DAG, fee-free
ChuẩnProprietaryW3C VC, DIDs, OpenID4VC
BatchThường có≤1000 docs (Business)
Agent-readyTuỳ vendorMCP docs có sẵn

Nói thẳng: nếu bạn chỉ cần verify CMND/hộ chiếu theo kiểu KYC-lite, Onfido/Persona vẫn nhanh hơn. Nhưng nếu bạn muốn verify bằng cấp, license, REC, chứng chỉ hành nghề — những thứ issuer đã digital-sign — thì Turing Verify đúng chỗ.

Use cases

  • Hiring & HR — auto-check bằng cấp, cert hành nghề ứng viên trước khi phỏng vấn cuối.
  • Onboarding & KYC — thay thế bước nhân viên nhìn PDF bằng 1 call API.
  • Education — verify transcript quốc tế tức thì. NTU (Đại học Quốc gia Đài Loan) đã dùng Turing Certs cho sinh viên quốc tế.
  • Healthcare — verify license y, chứng chỉ đào tạo nhân sự.
  • ESG / supply chain — verify Renewable Energy Certificate (REC), attestation nhà cung cấp.
  • Financial / AML — thay manual review bằng webhook async.
  • AI agent tool-use — agent gọi Verify như một tool MCP trước khi tin credential user upload.

Limitations & pricing

Điểm cần lưu ý trước khi tích hợp:

  • Batch endpoint chỉ Business tier — Pro chỉ verify từng doc.
  • Test mode deterministic — ra VERIFIED SAMPLE, tốt cho CI nhưng không test được adversarial thật.
  • Pricing API không public. Trang pricing Turing Certs list Essentials Pack ở €4,000/năm (US$4,700) cho 1,000 cert phía issuer; API integration nằm ở “Tailored Pack — Pricing on Demand”. Credit model: 1 credit/standard, 5 credit/deep. Không thấy free trial công khai.
  • Phụ thuộc IOTA/Shimmer. Sản phẩm claim credential vẫn valid kể cả khi issuer ngừng dịch vụ — nhưng đòi hỏi các chain này vẫn live.
  • SDK mới có Python + Node. Go/Rust/Java chưa có — phải gọi HTTP thô hoặc chờ.

What's next

Đây là lần đầu Turing Space mở developer surface cho mảng verify. Các bước hợp lý tiếp theo: thêm SDK (Go, Java, Rust), mở rộng batch tier, và đào sâu hướng MCP — vì /mcp/docs có sẵn cho thấy họ đang chơi hướng agent-native từ sớm, đúng lúc các đội đang ráo riết tìm tool verify cho AI agent trước khi agent tin user-supplied data.

Nếu bạn đang xây flow KYC, onboarding hay agent workflow — cầm tv_test_sk_* chạy thử, đọc reference, xem có fit không. Cost công bằng nhất có lẽ là dành 30 phút đọc OpenAPI schema trước khi quyết định.

Nguồn: turingcerts.com/verify, API reference, turingcerts.com, @thejeffhu trên X.