Início rápido

🇺🇸 Read in English

Este guia leva você da chave de API à primeira consulta. Você precisa de um usuário ativo no Media Ops.

1. Gere uma chave de API

1. Entre no Media Ops e abra Integrações.
2. Clique em Gerar chave, dê um nome (ex.: n8n produção), marque só as permissões necessárias e escolha a validade.
3. Copie a chave (mops_…). Ela é exibida uma única vez.

2. Confirme quem você é

Toda chamada envia a chave no cabeçalho Authorization:

export MEDIA_OPS_API_KEY="mops_..."
curl https://media.ops.infotrafego.com.br/api/v1/me \
  -H "Authorization: Bearer $MEDIA_OPS_API_KEY"

const res = await fetch("https://media.ops.infotrafego.com.br/api/v1/me", {
  headers: { Authorization: `Bearer ${process.env.MEDIA_OPS_API_KEY}` },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://media.ops.infotrafego.com.br/api/v1/me",
    headers={"Authorization": f"Bearer {os.environ['MEDIA_OPS_API_KEY']}"},
)
print(res.json())

A resposta traz seu usuário, o papel, o canal usado (api_key) e as permissões efetivas da chave. Um 401 indica chave ausente, revogada ou expirada.

3. Liste seus clientes

Com a permissão clients:read:

curl https://media.ops.infotrafego.com.br/api/v1/clients \
  -H "Authorization: Bearer $MEDIA_OPS_API_KEY"

Depois, GET /clients/{id}/businesses devolve as BMs do cliente com contas de anúncio, páginas, Instagram e pixels — é dali que saem o business_manager_id e o ad_account_id usados em todas as operações da Meta.

4. Experimente pela referência

Cada endpoint da Referência da API tem o botão Try It: informe sua chave em Authorization e execute direto pelo navegador. As chamadas usam a sua conta, então prefira endpoints de leitura e POST /campaigns/validate, que simula uma campanha sem criar nada.

Próximos passos