MultiTEL
Nhà phát triển

GET/tcr/v2/brand/{brandId}/externalVetting

Kiểm tra kết quả thẩm định của thương hiệu

Đọc kết quả thẩm định của một thương hiệu thuộc tài khoản của bạn và theo dõi một đợt thẩm định đã có qua các kết quả đang chờ xử lý, thành công hoặc thất bại.

Trên trang này
  1. Chọn thương hiệu bạn đang kiểm tra
  2. Theo dõi một đợt thẩm định đã có
  3. Tìm hiểu các khoản phí của yêu cầu đã đặt trước đó
  4. Thử đọc lại mà không đặt thêm yêu cầu
  5. Tách riêng các bước đăng ký
  6. Yêu cầu
  7. Phản hồi
  8. Lỗi
  9. Tính khả dụng và các tác động phát sinh

Chọn thương hiệu bạn đang kiểm tra

Sử dụng mã định danh thương hiệu thuộc tài khoản của bạn. Lưu mã này cùng các bản ghi thẩm định trả về để tránh nhầm đợt thẩm định của doanh nghiệp này với đợt thẩm định của doanh nghiệp khác. Không sử dụng mã định danh của tài khoản khác.

Theo dõi một đợt thẩm định đã có

Lưu các trường vettingId, evpId, vettingClass và vettingStatus nếu có. Cơ chế đồng bộ hóa hiện tại coi PENDING và UNSCORE là các kết quả vẫn đang chờ kiểm tra thêm, còn ACTIVE và FAILED là các kết quả cuối cùng để quyết toán phí. Đọc thông tin chi tiết trả về trước khi quyết định có cần thực hiện bước tiếp theo hay không. Chỉ riêng một danh sách trống không chứng minh rằng yêu cầu đã gửi trước đó chưa đến hệ thống đăng ký.

Tìm hiểu các khoản phí của yêu cầu đã đặt trước đó

Việc kiểm tra trạng thái không đặt thêm một đợt thẩm định. Tuy nhiên, thao tác này có thể đối soát một kết quả đã hoàn tất và quyết toán khoản phí gắn với yêu cầu thẩm định có tính phí đã đặt trước đó. Khoản phí này bao gồm phí thẩm định thất bại nếu áp dụng. Sử dụng mức giá và các điều khoản đã xem xét khi đặt yêu cầu; không suy ra mức giá hiện tại từ ví dụ cũ hoặc phản hồi trạng thái.

Thử đọc lại mà không đặt thêm yêu cầu

Nếu xảy ra lỗi tạm thời, hãy giữ lại mã định danh thương hiệu và các mã định danh thẩm định đã biết, tuân thủ Retry-After và thử đọc lại với thời gian chờ tăng dần giữa các lần thử. Không đặt yêu cầu thẩm định mới chỉ vì việc tra cứu trạng thái thất bại hoặc trả về phần nội dung không như dự kiến. Nếu sự không khớp vẫn tiếp diễn, hãy liên hệ MultiTEL qua kênh hỗ trợ có xác thực và cung cấp các mã tham chiếu liên quan.

Tách riêng các bước đăng ký

Việc thẩm định xác lập kết quả đánh giá cho thương hiệu. Xét điều kiện của chiến dịch, đăng ký chiến dịch và gán số điện thoại vẫn là các bước riêng biệt. Kiểm tra trạng thái hiện tại và các yêu cầu của từng bước trước khi gửi tin nhắn.

Yêu cầu

Sử dụng tài khoản API đã được bật, truy cập qua HTTPS từ địa chỉ IP nguồn được cho phép. Sử dụng thông tin xác thực của tài khoản bạn, không dùng thông tin xác thực của hệ thống đăng ký. Thương hiệu phải được liên kết với tài khoản đã xác thực.

Gửi GET với mã định danh thương hiệu trong đường dẫn và bộ lọc truy vấn bắt buộc vettingStatus. Lược đồ đã rà soát định nghĩa một mảng trạng thái; ví dụ này yêu cầu một giá trị ACTIVE duy nhất. Hướng dẫn này chưa xác định cách mã hóa nhiều giá trị hoặc việc nhà cung cấp chấp nhận yêu cầu không có bộ lọc. Không cần phần nội dung yêu cầu.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"
Tham số đường dẫn
TênKiểu dữ liệuBắt buộcMô tả
brandIdchuỗiCóMã định danh thương hiệu trong hệ thống đăng ký được liên kết với tài khoản MultiTEL của bạn. Đây không phải mã định danh tài khoản hay mã định danh thẩm định.
Tham số truy vấn
TênKiểu dữ liệuBắt buộcMô tả
vettingStatusmảng các chuỗiCóBộ lọc trạng thái bắt buộc. Các giá trị được cho phép: PENDING, UNSCORE, ACTIVE, FAILED, EXPIRED. Ví dụ cung cấp một giá trị ACTIVE duy nhất; không khẳng định cách mã hóa nhiều giá trị hoặc việc nhà cung cấp chấp nhận yêu cầu không có bộ lọc.

Phản hồi

Tuyến hiện tại giữ nguyên trạng thái HTTP và phần nội dung của hệ thống đăng ký thay vì dùng cấu trúc bao ngoài phản hồi v3 cũ. Mảng giả định rút gọn minh họa các trường được luồng đồng bộ hóa cục bộ sử dụng; đây không phải phản hồi thực tế được ghi lại từ hệ thống đăng ký hay một lược đồ được bảo đảm là đầy đủ. Kiểm tra trạng thái HTTP và JSON trước khi đọc các bản ghi. Lưu từng vettingId cùng thương hiệu đã chọn.

Cấu trúc phản hồi minh họa; không phải dữ liệu tài khoản thực tế hay báo giá hiện tại.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Lỗi

  • 401: Xác thực tài khoản thất bại. Kiểm tra thông tin xác thực, trạng thái bật API và các hạn chế IP nguồn đang áp dụng.
  • 404: Thương hiệu không được liên kết với tài khoản này hoặc hệ thống đăng ký không tìm thấy thương hiệu. Việc từ chối do quyền sở hữu tài khoản xảy ra trước khi gửi yêu cầu đến hệ thống đăng ký.
  • 429: Đã đạt giới hạn yêu cầu của tài khoản hoặc hệ thống đăng ký. Tuân thủ Retry-After và tăng dần thời gian chờ giữa các lần thử.
  • 502/503: Kết nối truyền tải, hệ thống đăng ký, bộ giới hạn yêu cầu hoặc quá trình xử lý cục bộ không khả dụng. Lỗi không chứng minh rằng yêu cầu thẩm định trước đó đã thất bại.

Tính khả dụng và các tác động phát sinh

  • Thao tác GET này không đặt yêu cầu thẩm định mới. Thao tác này lấy kết quả từ hệ thống đăng ký, ghi bản ghi kiểm toán yêu cầu và đồng bộ hóa các kết quả đã lưu.
  • Việc đọc một kết quả đã hoàn tất có thể quyết toán khoản phí cho yêu cầu thẩm định có tính phí đã đặt trước đó. Đợt thẩm định thất bại có thể phát sinh phí thất bại nếu áp dụng. Xem xét mức giá và các điều khoản khi đặt yêu cầu; thao tác đọc này không phải là báo giá.
  • Bản ghi mới được phát hiện và nhập qua thao tác GET này không tự động được phân loại là yêu cầu mới có tính phí.
  • Kết quả thẩm định thành công hoặc ACTIVE không đồng nghĩa với việc chiến dịch được phê duyệt, số điện thoại được gán hay được phép gửi tin nhắn.