Nhận diện thời gian thực

Nhận diện thời gian thực trả lời ngay một câu hỏi về một định danh: số điện thoại này — hoặc địa chỉ email này — có đăng ký trên một nền tảng nhất định hay không?

Engine chính là engine mà console dùng. Nó nhận một số điện thoại hoặc địa chỉ email, đối chiếu với một đến mười sản phẩm thời gian thực, và trả về kết luận cho từng sản phẩm.

Khi nào nên dùng

Bạn có	Dùng
Một định danh, hoặc vài định danh, và cần kết quả ngay	Thời gian thực
Hàng nghìn định danh, và có thể chờ	Nhận diện hàng loạt

Các trường hợp thời gian thực điển hình là kiểm tra biểu mẫu khi đăng ký hoặc thanh toán, tra cứu một lần trong một công cụ nội bộ, và một số ít lần kiểm tra trong một workflow đang chạy. Hàng loạt được thiết kế cho file và mảng lớn: bất đồng bộ, tính giá theo từng dòng đã kiểm tra, và tác vụ đã xong có thể tải về.

Hai chuỗi, một hợp đồng

Chuỗi được mang trong path, và phải khớp với các sản phẩm bạn chọn:

Chuỗi	Endpoint	identifier
Điện thoại	POST /v1/realtime/check/phone	Số E.164, ví dụ +8613800138000
Email	POST /v1/realtime/check/email	Địa chỉ email, ví dụ user@example.com

Một request không được trộn chuỗi: chọn một sản phẩm điện thoại và một sản phẩm email trong cùng một lệnh gọi sẽ bị từ chối. country là tuỳ chọn với số E.164 đầy đủ, và phải bỏ qua với email.

Một lệnh gọi được tính như thế nào

Một lệnh gọi nhận một định danh và một đến mười sản phẩm:

• một request_id cho lệnh gọi
• một mục cho mỗi sản phẩm trong results
• một khoản thu cho mỗi mục

Vì mỗi mục được tính phí riêng, một lệnh gọi có thể thành công với sản phẩm này và thất bại với sản phẩm khác. Trường hợp đó được báo là status: partial_succeeded, và mỗi mục mang billing_status riêng — hãy đọc chúng thay vì chỉ tin HTTP 200.

Các trang trong mục này

• Kiểm tra thời gian thực cho điện thoại — endpoint điện thoại đầy đủ
• Kiểm tra thời gian thực cho email — endpoint email đầy đủ
• Sản phẩm thời gian thực — danh sách trực tiếp các sản phẩm bạn có thể chọn, và cách đọc ID từ đó
• Idempotency & thử lại — vì sao Idempotency-Key là bắt buộc, và các lần thử lại hoạt động thế nào
• Thanh toán & hoàn tiền — cái gì bị thu, cái gì được hoàn, và khi nào
• Ví dụ cURL / SDK — các lệnh gọi sao chép dán cho những trường hợp phổ biến

Trước khi thực hiện lệnh gọi đầu tiên

1. Cần có API key — xem Xác thực.
2. Đọc ID sản phẩm bạn định dùng từ Sản phẩm thời gian thực.
3. Gửi Idempotency-Key duy nhất trong mọi lệnh gọi; đây là bắt buộc, không phải tuỳ chọn.