Kiểm tra lại danh tính doanh nghiệp đã được sửa
Dùng thao tác này khi thương hiệu tổ chức hiện có cần được kiểm tra lại thông tin danh tính đã sửa. Trước tiên, hãy cập nhật thương hiệu hiện có, rồi đọc trạng thái danh tính hiện tại của thương hiệu. Việc cập nhật hồ sơ thông thường không gửi yêu cầu kiểm tra có tính phí riêng này. Xác minh lại không tạo thêm thương hiệu hay đăng ký chiến dịch.
Sử dụng tài khoản API của chính bạn đã được kích hoạt, kết nối qua HTTPS từ địa chỉ IP nguồn được phép. Thương hiệu phải thuộc tài khoản đó. Giữ bí mật hồ sơ thương hiệu vì chúng chứa thông tin doanh nghiệp và thông tin liên hệ.
Rà soát thương hiệu trước khi gửi yêu cầu
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonKiểm tra để bảo đảm thương hiệu được trả về đúng là doanh nghiệp bạn muốn xử lý và đã có thông tin sửa đổi. Chưa thể xác minh lại khi đăng ký ban đầu vẫn đang chờ xử lý. Cơ quan đăng ký có thể từ chối yêu cầu nếu thông tin doanh nghiệp không thay đổi. Nếu thiếu các thuộc tính đặc biệt, có thể cần khiếu nại thay vì kiểm tra danh tính thêm lần nữa. Thương hiệu của doanh nghiệp tư nhân một chủ sử dụng quy trình danh tính/PIN phù hợp; không dùng điểm cuối này để thay thế quy trình đó.
Xác nhận khoản phí riêng
Phí xác minh lại trong môi trường thực tế hiện được cấu hình là US$5.00 cho mỗi lần kiểm tra được tiếp nhận, được kiểm tra vào ngày 24 tháng Mười năm 2026. Mức phí thương hiệu tiêu chuẩn được áp dụng, kể cả khi pháp nhân ban đầu có mức phí đăng ký khác. Chức năng mua phải được bật; tài khoản trả trước cần có đủ số dư trước khi gửi yêu cầu.
Phản hồi 202 có nghĩa là yêu cầu đã được tiếp nhận để tiếp tục xử lý, và lệnh thu phí được gửi đi ngay khi tiếp nhận. Điều này không có nghĩa là doanh nghiệp đã được xác minh. Một lần kiểm tra mới sau đó có thể phát sinh thêm phí. Không tạo lần kiểm tra mới chỉ vì việc xác minh vẫn đang chờ xử lý.
Gửi một lần kiểm tra theo dự định
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"Không cần gửi nội dung hồ sơ trong phần thân yêu cầu: thao tác này kiểm tra thông tin thương hiệu đã được lưu. Sử dụng một khóa chống xử lý trùng lặp duy nhất cho lần kiểm tra dự định thực hiện, đồng thời giữ nguyên chính xác phương thức, đường dẫn, chuỗi truy vấn và phần thân khi thử lại. Khóa hỗ trợ 1–128 ký tự ASCII có thể in, không có dấu cách. Yêu cầu trùng lặp với một yêu cầu đang xử lý có thể trả về 409 kèm Retry-After; một lần kiểm tra đã hoàn tất có thể trả lại kết quả đã lưu, kể cả lỗi.
API công khai cũng chấp nhận xác thực Bearer cho tài khoản dùng mã thông báo đã được kích hoạt. Các kiểm tra về quyền sở hữu tài khoản và địa chỉ IP nguồn được phép vẫn được áp dụng. Những thương hiệu mô phỏng đã lưu bỏ qua quy trình tính phí trong môi trường thực tế này, nhưng kết quả trong môi trường thử nghiệm không phải là xác minh danh tính trong môi trường thực tế.
Đọc kết quả và theo dõi trạng thái
| Phản hồi | Ý nghĩa và hành động tiếp theo |
|---|---|
| 200 | Yêu cầu đã thành công. Kiểm tra thương hiệu được trả về và đọc lại hồ sơ thương hiệu hiện tại để xác nhận trạng thái danh tính. |
| 202 | Đã tiếp nhận, đang chờ xác minh thêm. Giữ lại mã định danh thương hiệu và kiểm tra trạng thái hiện tại sau đó mà không gửi thêm một lần kiểm tra có tính phí. |
| 400 | Xem lại các lỗi do cơ quan đăng ký trả về. Đăng ký ban đầu có thể đang chờ xử lý, hồ sơ có thể chưa thay đổi hoặc có thể đang áp dụng một quy tắc kiểm tra tính hợp lệ khác. |
| 401 / 404 | Kiểm tra thông tin xác thực và địa chỉ IP được phép, hoặc mã định danh của thương hiệu thuộc tài khoản. |
| 402 / 503 | Xem lại lỗi cục bộ liên quan đến mua hàng/nạp tiền hoặc định giá/dịch vụ. Không cho rằng mọi phản hồi 503 đều chứng minh chưa có yêu cầu nào được gửi đến hệ thống phía trên. |
| 429 | Tuân thủ Retry-After và giữ nguyên thông tin của lần kiểm tra. |
Máy chủ trung gian làm mới hồ sơ thương hiệu cục bộ sau khi một thao tác thay đổi được tiếp nhận; riêng việc làm mới đó không chứng minh kết quả xác minh cuối cùng. Doanh nghiệp có thể vẫn chưa được xác minh hoặc đang chờ xử lý. Trước khi tiếp tục thiết lập chiến dịch, hãy căn cứ vào trạng thái thương hiệu hiện tại thay vì chỉ dựa vào việc tiếp nhận qua HTTP.
Xử lý khi kết quả chưa rõ ràng
Lỗi truyền tải có thể tạo ra phản hồi 502 được lưu vào bộ nhớ đệm. Một yêu cầu đã được hệ thống phía trên tiếp nhận nhưng sau đó gặp lỗi lưu dữ liệu cục bộ hoặc tính phí có thể tạo ra phản hồi 500 được lưu vào bộ nhớ đệm kèm requestId. Giữ lại mã định danh đó và phối hợp với bộ phận hỗ trợ để đối soát trạng thái thương hiệu và tính phí hiện tại. Tạo khóa khác có thể tạo ra một lần kiểm tra bị tính phí riêng; không tùy tiện thử lại bằng khóa mới.
Sử dụng cổng thông tin khách hàng
Cổng thông tin cho phép xác minh lại tổ chức trong môi trường thực tế có trạng thái UNVERIFIED sau khi rà soát hồ sơ và khoản phí hiện tại. Cổng thông tin kiểm tra để bảo đảm hồ sơ và giá không thay đổi, đồng thời từ chối tiếp nhận thêm yêu cầu cho cùng bộ thông tin hiện tại đã có yêu cầu được tiếp nhận. Thương hiệu trong môi trường thử nghiệm và thương hiệu của doanh nghiệp tư nhân một chủ không được sử dụng thao tác này trên cổng thông tin.
Những biện pháp bảo vệ trên cổng thông tin là các bước kiểm tra bổ sung trong quy trình. Ứng dụng khách gọi trực tiếp API phải tự thực hiện việc rà soát và không được cho rằng API yêu cầu các trường phiên bản hoặc xác nhận giá của cổng thông tin. Lưu một chỉnh sửa thương hiệu thông thường là thao tác riêng và không tự động gửi yêu cầu xác minh lại.