Sử dụng thương hiệu nhắn tin thuộc sở hữu của tài khoản
Sử dụng tài khoản API đã được kích hoạt qua HTTPS từ địa chỉ IP nguồn được cho phép. Hỗ trợ xác thực Basic và Bearer. Mã định danh thương hiệu phải thuộc tài khoản đó. Giữ bí mật các mã thông báo của nhà cung cấp, dữ liệu định danh thương hiệu và báo cáo được trả về.
Đặt một lần thẩm định bên ngoài mới
Sử dụng POST khi cần nhà cung cấp thẩm định thực hiện một lần kiểm tra mới cho thương hiệu này. Nếu đã có kết quả từ nhà cung cấp, hãy sử dụng chức năng nhập kết quả thay thế. Thao tác này tách biệt với xác minh lại danh tính thương hiệu.
Trước tiên, hãy đọc thông tin hiện tại của thương hiệu và xác nhận thông tin định danh. Chọn nhà cung cấp và loại thẩm định được hỗ trợ từ các danh mục hiện hành và kiểm tra các yêu cầu của nhà cung cấp đó. Không phải nhà cung cấp nào cũng hỗ trợ mọi loại thẩm định. Các chi tiết bổ sung cho thẩm định chính trị phải mô tả tổ chức hoặc chiến dịch thực tế, không được dùng dữ liệu mẫu.
Chuẩn bị yêu cầu gửi nhà cung cấp
| Trường | Giá trị |
|---|---|
| evpId | Mã định danh nhà cung cấp bắt buộc lấy từ danh mục nhà cung cấp thẩm định bên ngoài hiện hành, dài 1–10 ký tự. |
| vettingClass | Loại thẩm định được hỗ trợ mà bạn định mua; hãy chọn rõ loại này và xác nhận giá. |
| additionalRequestPayload | Một chuỗi được mã hóa theo JSON chứa các chi tiết riêng của nhà cung cấp, bắt buộc đối với thẩm định chính trị. Đây là một chuỗi bên trong đối tượng JSON ngoài cùng, không phải đối tượng lồng nhau. Xác nhận tất cả chi tiết bắt buộc với nhà cung cấp đã chọn. |
Xác nhận phí khi thành công và khi thất bại
Mức phí bán lẻ hiện hành bằng đô la Mỹ, được tra cứu vào ngày 24 tháng Mười năm 2026. Xác nhận số tiền hiện hành trước khi đặt dịch vụ thực tế. Số dư trả trước được kiểm tra đối chiếu với giá khi thành công; chức năng mua hàng phải được bật.
| Loại thẩm định | Kết quả có hiệu lực | Kết quả thất bại |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL với yêu cầu Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Các đơn đặt dịch vụ đang chờ xử lý giữ nguyên số tiền áp dụng khi thành công/thất bại và được quyết toán khi kết quả ACTIVE hoặc FAILED được đồng bộ. Hai loại cuối cùng trong bảng áp dụng cùng một mức phí đã cấu hình cho cả hai kết quả kết thúc. Nếu có kết quả kết thúc ngay lập tức, phí có thể được tính trong lúc trả về phản hồi đặt dịch vụ. Việc đồng bộ trạng thái sau đó có thể quyết toán khoản phí đang chờ xử lý.
Không được coi mock:true là lời bảo đảm rằng việc thẩm định bên ngoài sẽ miễn phí. Quy trình quyết toán thẩm định bên ngoài hiện tại vẫn có thể ghi nhận và tính phí đơn đặt dịch vụ đó. Các hướng dẫn này không yêu cầu mua dịch vụ thực tế để thử nghiệm; hãy dùng dữ liệu kiểm thử ngoại tuyến cho đến khi bạn có ý định cho phép thực hiện một lần thẩm định có tính phí.
Gửi một đơn đặt dịch vụ đã được rà soát
Chuẩn bị vetting-order.json với mã định danh nhà cung cấp, loại thẩm định và mọi thông tin bổ sung bắt buộc. Tệp này chứa yêu cầu thực tế mà bạn định gửi. Giữ bí mật tệp này.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Theo dõi kết quả thực tế
Phản hồi HTTP thành công có thể chứa một bản ghi thẩm định đang chờ xử lý. Lưu lại vettingId của bản ghi và kiểm tra vettingStatus, lý do, điểm số và ngày có hiệu lực/hết hạn nếu có. PENDING và UNSCORE cần được tiếp tục theo dõi; ACTIVE, FAILED và EXPIRED mô tả các kết quả khác nhau. Chỉ riêng việc được chấp nhận ở cấp HTTP không chứng minh rằng điểm số là thuận lợi hoặc chiến dịch đủ điều kiện.
Sử dụng trạng thái thẩm định bên ngoài để theo dõi bản ghi. Việc đọc hoặc nhập kết quả kết thúc có thể quyết toán một đơn đặt dịch vụ có tính phí trước đó; thao tác này không nhất thiết miễn trừ khoản phí còn tồn đọng.
Thử lại đúng yêu cầu đã định gửi
Sử dụng một Idempotency-Key cho mỗi thao tác dự định thực hiện và giữ nguyên chính xác phương thức, đường dẫn, chuỗi truy vấn và các byte của phần thân yêu cầu. Khóa hỗ trợ 1–128 ký tự ASCII có thể in được, không có dấu cách. Một yêu cầu trùng lặp trong khi yêu cầu gốc đang được xử lý có thể trả về 409 kèm Retry-After. Các yêu cầu đã hoàn tất sẽ trả lại phản hồi đã lưu, bao gồm cả lỗi. Tuân thủ giới hạn tần suất yêu cầu.
Lỗi 502 được lưu trong bộ nhớ đệm có thể xuất hiện sau lỗi truyền tải. Lỗi 500 được lưu trong bộ nhớ đệm kèm requestId có thể có nghĩa là hệ thống đăng ký đã chấp nhận thao tác nhưng việc lưu trữ cục bộ hoặc tính phí đã thất bại. Giữ lại mã định danh yêu cầu, kiểm tra các bản ghi hiện tại và đối soát với bộ phận hỗ trợ trước khi sử dụng khóa mới. Không được cho rằng lỗi này có nghĩa là không có đơn đặt dịch vụ nào tồn tại.