matrix clipping · ferramenta

MatrixAPI

Todas as ferramentas da Matrix funcionando dentro do seu sistema. Crie um token, escolha o que ele pode fazer e integre em minutos.

# MatrixShot · screenshot de uma página
curl -X POST https://api.matrixclipping.com.br/v1/matrixshot \
  -H "Authorization: Bearer mc_live_…" \
  -d '{"url":"https://portal.demo/noticia","pagina_inteira":true}'

# MatrixMeter · medidas e centimetragem
curl -X POST https://api.matrixclipping.com.br/v1/matrixmeter \
  -H "Authorization: Bearer mc_live_…" \
  -d '{"largura_px":620,"altura_px":480}'
endpoints

Uma chamada para cada ferramenta.

Respostas em JSON, mensagens de erro claras e o consumo em cada resposta.

POST/v1/matrixshotMatrixShotScreenshot de um link
POST/v1/matrixshot/loteMatrixShotLote de links, com retorno por webhook
POST/v1/matrixlinkMatrixLinkTítulo, texto, data, autor e veículo de um link
POST/v1/matrixmeterMatrixMeterAltura, largura e centimetragem
POST/v1/matrixdocMatrixDocPDF ou Excel para JSON ou INSERT
GET/v1/consumoContaConsumo do mês e limite
segurança

Seguro desde o primeiro token.

Cada token tem o seu escopo, aparece uma única vez e pode ser revogado na hora.

  • Tokens com escopos
  • Revogação imediata
  • Conexão sempre em HTTPS
  • Limite mensal com alerta
  • Consumo separado por origem
  • Histórico de uso de cada token
# resposta
{
  "largura_cm": 16.4,
  "altura_cm": 12.7,
  "centimetragem_cm2": 208.28,
  "consumo": { "usado": 1284, "limite": 3000 }
}
# MatrixAPI · webhook enviado ao fim do lote
POST https://seu-sistema.com.br/matrix
{
  "evento": "lote.concluido",
  "ferramenta": "MatrixLink",
  "lote": "L-20261120-01",
  "total": 1000,
  "sucesso": 998,
  "arquivos": "https://…/L-20261120-01.zip"
}
webhook

Avisamos quando o lote termina.

Nada de ficar consultando: o seu sistema recebe um aviso com o resumo do lote e o link dos resultados.

  • Aviso ao fim de cada lote
  • Nova tentativa automática se o seu sistema estiver fora
  • Assinatura de segurança em cada aviso
  • Mais de um endereço por conta
perguntas

Sobre a MatrixAPI.

O que é a MatrixAPI?

É a API da Matrix Clipping: as mesmas ferramentas do painel (MatrixShot, MatrixLink, MatrixMeter e MatrixDoc) chamadas direto do seu sistema, com respostas em JSON.

Como funciona a autenticação?

Você cria um token no painel e envia no cabeçalho Authorization de cada chamada. O token aparece uma única vez e pode ser revogado a qualquer momento.

O que são escopos?

São as permissões do token: ele pode só ler o consumo, só executar o MatrixShot, ou o que você liberar. Um token vazado não abre mais do que deveria.

O consumo pela API é diferente do painel?

Não. Cada chamada conta na mesma franquia mensal, e você acompanha tudo no consumo, separado por origem.

Preciso ficar consultando se o lote terminou?

Não. A MatrixAPI avisa o seu sistema por webhook quando o lote termina.

matrix clipping

A ferramenta certa muda o ritmo da operação.

MatrixShot, MatrixLink, MatrixMeter, MatrixDoc e MatrixAPI: menos trabalho manual, mais entrega para a sua equipe.