Xây dựng logic xác thực

Tài liệu này mô tả quy trình xây dựng hệ thống kiểm tra địa chỉ để xử lý nhiều loại phản hồi từ Address Validation API. Tài liệu này trình bày cách xây dựng logic để sử dụng phản hồi một cách chính xác, điều tra các tín hiệu khác từ API, cũng như thời điểm và cách nhắc khách hàng cung cấp thêm thông tin.

Nhìn chung, phản hồi của API xác định những cách sau đây mà hệ thống của bạn nên xử lý một địa chỉ:

• handyman Khắc phục – địa chỉ có chất lượng thấp. Bạn nên yêu cầu cung cấp thêm thông tin.
• edit Xác nhận – địa chỉ có chất lượng cao nhưng có thay đổi so với địa chỉ đầu vào. Bạn có thể nhắc xác nhận.
• check Chấp nhận – địa chỉ có chất lượng cao. Bạn có thể chấp nhận địa chỉ được cung cấp.

Mục đích chính

Tài liệu này giúp bạn sửa đổi hệ thống để phân tích phản hồi của API một cách hiệu quả nhất và xác định các hành động tiếp theo cần thực hiện với địa chỉ được cung cấp. Mã giả sau đây minh hoạ một quy trình có thể xảy ra.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

Logic chính xác phụ thuộc vào tình huống của bạn; hãy xem Hướng dẫn triển khai để biết thêm thông tin chi tiết. Bạn cũng có thể sử dụng phương thức triển khai nguồn mở của chúng tôi cho logic này, trong Thư viện thành phần mở rộng.

Tổng quan về quy trình công việc

Bảng dưới đây tóm tắt hai hành động cho hệ thống của bạn:

1. Quy trình công việc cần sử dụng dựa trên hành vi khắc phục, xác nhận, chấp nhận.
2. Tín hiệu đầu tiên cần kiểm tra trong phản hồi. Các tín hiệu được mô tả ở đây đến từ thuộc tính verdict và không phải là tín hiệu duy nhất cần kiểm tra, nhưng cung cấp chỉ báo ban đầu về chất lượng địa chỉ. Mỗi loại hành vi tương ứng với một phần trong tài liệu này, mô tả các tín hiệu khác mà bạn cũng có thể cần điều tra.

Hướng dẫn triển khai

Khi thiết kế cách hệ thống phản hồi các tín hiệu xác thực địa chỉ, bạn có thể tham khảo các đề xuất sau để xây dựng một mô hình phản hồi hiệu quả hơn. Tuy nhiên, đây chỉ là các đề xuất, vì vậy, hãy lưu ý rằng việc triển khai của bạn phải phù hợp với mô hình kinh doanh của bạn.

Sửa địa chỉ

Sửa địa chỉ khi kết quả cho thấy rõ ràng rằng địa chỉ đó không thể giao hàng. Sau đó, hệ thống của bạn có thể nhắc khách hàng cung cấp thông tin cần thiết, rồi bạn phát hành lại quy trình làm việc để nhận được địa chỉ có thể giao hàng.

Khắc phục tín hiệu

Address Validation API cung cấp một số tín hiệu để cho bạn biết liệu một địa chỉ có cần được sửa hay không.

1. Mức độ chi tiết của quy trình xác thực và các thành phần bị thiếu

Hai tín hiệu sau đây cho biết rõ nhất về một địa chỉ có vấn đề:

• Bất cứ khi nào trường validationGranularity là OTHER, hệ thống của bạn nên điều tra các tín hiệu thành phần địa chỉ để tìm hiểu thêm về nơi xảy ra lỗi và cách khắc phục.
• Bất cứ khi nào đối tượng address sau khi xử lý trả về một trường missingComponentTypes, hệ thống của bạn sẽ kiểm tra thành phần đó. Việc thiếu các thành phần cũng khiến địa chỉ không đầy đủ và không thể giao hàng.

2. Các tín hiệu khác

Address Validation API cũng cung cấp các tín hiệu khác để giúp chẩn đoán các vấn đề cụ thể:

3. Tín hiệu về địa chỉ ở Hoa Kỳ

Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cung cấp tín hiệu hữu ích cho biết địa chỉ đó không thể giao hàng và cần được sửa. Đối với địa chỉ cần chỉnh sửa, bạn sẽ thấy thông tin sau:

Để biết thông tin chi tiết về dpvConfirmation, hãy xem bài viết Xử lý địa chỉ ở Hoa Kỳ.

Ví dụ về cách chỉnh sửa địa chỉ

Xác nhận địa chỉ

Bạn xác nhận một địa chỉ khi kết quả cho biết Address Validation API đã suy luận hoặc thay đổi các thành phần địa chỉ để tạo ra một địa chỉ đã xác thực. Trong những trường hợp này, bạn có một địa chỉ có thể giao hàng, nhưng muốn tin tưởng hơn rằng địa chỉ thu được là địa chỉ mà khách hàng dự định.

Để đưa ra lời nhắc chính xác cho khách hàng, logic của bạn sẽ xác định các thành phần được dịch vụ gắn cờ để xác định hành động hoặc cờ nào mà API áp dụng cho thành phần đó, chẳng hạn như inferred, replaced hoặc spellCorrected. Xem AddressComponent trong tài liệu tham khảo.

Xác nhận tín hiệu

Address Validation API cung cấp một số tín hiệu để cho bạn biết liệu một địa chỉ có cần được xác nhận hay không.

1. Độ chi tiết của quy trình xác thực

validationGranularity ROUTE trở lên là chấp nhận được, nhưng PREMISE hoặc SUBPREMISE sẽ cung cấp tín hiệu mạnh hơn về khả năng gửi thư.

2. Các tín hiệu khác

Khi quyết định xác nhận việc nhập địa chỉ với khách hàng, kết quả cũng cung cấp những thông tin sau để xác định thành phần cần điều tra:

3. Tín hiệu về địa chỉ ở Hoa Kỳ

Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cho biết rằng logic của bạn phải xác nhận thông tin chi tiết với khách hàng. Một trong hai trường hợp sau:

Ví dụ về địa chỉ xác nhận

Chấp nhận địa chỉ

Bạn chấp nhận một địa chỉ khi kết quả cho thấy mức độ tin cậy cao rằng địa chỉ đó có thể giao hàng và có thể được sử dụng mà không cần khách hàng tương tác thêm trong quy trình tiếp theo.

Chấp nhận tín hiệu

Address Validation API cung cấp một số tín hiệu để cho bạn biết liệu một địa chỉ có cần được xác nhận hay không.

1. Độ chi tiết của quy trình xác thực

validationGranularity của PREMISE trở lên là chấp nhận được, nhưng trong một số trường hợp, ROUTE vẫn cho biết địa chỉ có thể gửi thư.

2. Các tín hiệu khác

Kết quả cho một địa chỉ chất lượng cao cũng phải cung cấp những thông tin sau:

• Không có dữ liệu bị thay thế. Trong trường hợp này, hasReplacedComponents: FALSE.
• Không có thành phần nào được suy luận. Trong trường hợp này, hasInferredComponents: FALSE.

3. Tín hiệu về địa chỉ ở Hoa Kỳ

Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cho biết địa chỉ chất lượng cao có thể giao hàng đến. Đối với địa chỉ hợp lệ ở Hoa Kỳ, bạn sẽ thấy thông tin sau:

Ví dụ về địa chỉ được chấp nhận