Use uma marca de mensagens que pertença à conta
Use uma conta API habilitada por HTTPS a partir de um endereço IP de origem permitido. Há suporte à autenticação Basic e Bearer. O ID da marca deve pertencer a essa conta. Mantenha em sigilo os tokens do provedor, os dados de identidade da marca e os relatórios recebidos.
Solicite uma nova verificação externa
Use POST quando precisar que um provedor de avaliação realize uma nova verificação desta marca. Se já tiver um resultado do provedor, use a importação em vez disso. Essa operação é separada da nova verificação da identidade da marca.
Primeiro, consulte a marca atual e confirme suas informações de identidade. Selecione uma combinação de provedor e classe compatível nos catálogos atuais e verifique os requisitos desse provedor. Nem todos os provedores oferecem suporte a todas as classes. Os detalhes adicionais da avaliação política devem descrever a organização ou campanha real, e não conter dados de exemplo.
Prepare a requisição ao provedor
| Campo | Valor |
|---|---|
| evpId | ID obrigatório do provedor, obtido no catálogo atual de provedores de avaliação externa, com 1–10 caracteres. |
| vettingClass | A classe compatível que você pretende comprar; selecione-a explicitamente e confirme seu preço. |
| additionalRequestPayload | Uma cadeia de caracteres codificada em JSON com detalhes específicos do provedor, obrigatória para a avaliação política. Trata-se de uma cadeia de caracteres dentro do objeto JSON externo, e não de um objeto aninhado. Confirme todos os detalhes obrigatórios com o provedor selecionado. |
Confirme as cobranças por sucesso e por falha
Tarifas de varejo atuais em dólares americanos, consultadas em 24 de outubro de 2026. Confirme o valor vigente antes de fazer um pedido real. É verificado se o saldo pré-pago cobre o preço por sucesso; as compras devem estar habilitadas.
| Classe | Resultado ativo | Resultado com falha |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL com pedido Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Os pedidos pendentes mantêm seus valores por sucesso e por falha e são liquidados quando um resultado ACTIVE ou FAILED é sincronizado. As duas últimas classes usam a mesma tarifa configurada para qualquer um dos dois resultados finais. Um resultado final imediato pode gerar uma cobrança durante a resposta ao pedido. Uma sincronização posterior do status pode liquidar uma cobrança pendente.
Não use mock:true como garantia de uma avaliação externa gratuita. O processo atual de liquidação de avaliações externas ainda pode registrar e cobrar esse pedido. Estas instruções não exigem uma compra real para testes; use dados de teste sem conexão até que pretenda autorizar uma verificação paga.
Envie um único pedido revisado
Prepare vetting-order.json com o ID do provedor, a classe e todas as informações adicionais obrigatórias. O arquivo contém a requisição real que você pretende enviar. Mantenha-o em sigilo.
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"Acompanhe o resultado real
Uma resposta HTTP bem-sucedida pode conter um registro de avaliação pendente. Guarde seu vettingId e consulte vettingStatus, os motivos, a pontuação e as datas de início de vigência e expiração, conforme disponíveis. PENDING e UNSCORE exigem acompanhamento adicional; ACTIVE, FAILED e EXPIRED descrevem resultados diferentes. A aceitação HTTP, por si só, não comprova uma pontuação favorável nem a elegibilidade da campanha.
Use o status da avaliação externa para acompanhar o registro. Consultar ou importar um resultado final pode liquidar um pedido pago anterior; isso não significa necessariamente estar isento de uma cobrança pendente já existente.
Tente novamente a mesma requisição pretendida
Use uma Idempotency-Key por operação pretendida e preserve exatamente o método, o caminho, a consulta e os bytes do corpo. As chaves aceitam 1–128 caracteres ASCII imprimíveis, sem espaços. Uma requisição duplicada cuja operação ainda esteja em andamento pode retornar 409 com Retry-After. As requisições concluídas retornam novamente a resposta armazenada, incluindo erros. Respeite os limites de frequência.
Uma falha de transporte pode resultar em um 502 armazenado em cache. Um 500 armazenado em cache com requestId pode significar que o registro aceitou a operação, mas houve falha na persistência local ou no faturamento. Preserve o ID da requisição, consulte os registros atuais e esclareça e concilie a situação com a equipe de suporte antes de usar uma nova chave. Não presuma que o erro significa que nenhum pedido existe.