API SMI v2

Documentação de integração  ·  swagger.json (OpenAPI 3.0)

Convenções

Autenticação

A API usa token de acesso enviado no header Authorization: Bearer <token>. O token é obtido trocando uma assinatura por um token temporário.

1. Chaves de acesso

As chaves são geradas na área administrativa (Admin → TI → Usuários da API):

2. Cálculo da assinatura

assinatura = hex( Hash( timestamp + chave_privada ) )

Exemplo em JavaScript:

var timestamp  = Math.round(new Date().getTime() / 1000);
var assinatura = CryptoJS.SHA256(timestamp + chavePrivada).toString();

3. Obter o token

Método: POST

https://api.linearc.com.br/auth/

Content-Type: application/x-www-form-urlencoded

Parâmetros:

Nome Descrição Formato Obrigatório
usuario Login do usuário de API. String Sim
chave_publica Chave pública do usuário. String Sim
timestamp Unix timestamp (segundos, UTC) usado no cálculo da assinatura. Numérico Sim
assinatura hex(Hash(timestamp + chave_privada)) – SHA-256 (64) ou MD5 (32). String Sim

Exemplo:

curl -X POST 'https://api.linearc.com.br/auth/' \
  --data-urlencode 'usuario=nomedousuario' \
  --data-urlencode 'chave_publica=E62B0545D2FCE4B2C9656030468ED282711' \
  --data-urlencode 'timestamp=1791481512' \
  --data-urlencode 'assinatura=6b1c9f2e...'

Resposta (200):

{
    "success": true,
    "data": [
        {
            "token_type": "Bearer",
            "access_token": "8f0c1d...",
            "expires_in": 3600
        }
    ]
}

expires_in é a validade do token em segundos (60 minutos).

Erros:

HTTP message_error Quando acontece
400 Parâmetros de autenticação incompletos. Faltou usuario, chave_publica, timestamp ou assinatura.
401 Usuário ou chave pública inválidos. O usuário não existe como usuário de API ou a chave pública não confere.
401 Assinatura inválida. A assinatura calculada não corresponde à chave privada.
403 Acesso não autorizado a partir deste IP. O usuário tem restrição de IP e a origem não está autorizada.

4. Usar o token

Envie o token em todas as chamadas:

Authorization: Bearer <access_token>

Ao expirar (ou se o token for revogado), a API responde 401 e basta repetir o passo 3 para obter um novo token.

5. Encerrar o token (logout)

Método: POST

https://api.linearc.com.br/auth/logout/

Header: Authorization: Bearer <access_token>

curl -X POST 'https://api.linearc.com.br/auth/logout/' -H 'Authorization: Bearer <access_token>'

Resposta (200): { "success": true, "data": [] }

6. Permissões por rota

Além do token, a rota precisa estar liberada para o usuário. A liberação é feita na área administrativa (Admin → TI → Usuários da API, ação “Permissões de rotas”). Sem nenhuma rota marcada, o usuário não acessa nenhum endpoint.

noticia/lista

Lista as notícias do clipping do sistema informado, com os mesmos filtros da busca do portal. Use para carregar a base já coletada e para sincronizar apenas o que é novo.

Método: POST

https://api.linearc.com.br/noticia/lista/

Content-Type: application/x-www-form-urlencoded
Header: Authorization: Bearer <access_token>

Parâmetros:

Nome Descrição Formato Obrigatório
sistema Sigla do sistema (a mesma das outras rotas, ex.: mec). String Sim
palavra_chave Texto livre, pesquisado no título e no conteúdo. String Não
ultima_noticia id da última notícia já recebida. A busca devolve somente as mais novas – é assim que se pagina. Numérico Não
data Data inicial do período. Ausente = hoje. dd/mm/aaaa Não
data_fim Data final do período. Ausente = hoje. dd/mm/aaaa Não
categoria Um ou mais id de categoria, separados por vírgula. Numérico Não
veiculo Um ou mais id de veículo, separados por vírgula. Numérico Não
midia Tipo do veículo (IMP, RAD, TVS...). String Não
tp_avaliacao Código do tipo de avaliação (ex.: A-2107-1). String Não

Parâmetro não enviado é tratado como nulo pela procedure, ou seja, o filtro simplesmente não é aplicado. sistema também é aceito na query string (?sistema=mec), como nas demais rotas.

Exemplo:

curl -X POST 'https://api.linearc.com.br/noticia/lista/' \
  -H 'Authorization: Bearer <access_token>' \
  --data-urlencode 'sistema=mec' \
  --data-urlencode 'data=01/10/2026' \
  --data-urlencode 'data_fim=08/10/2026' \
  --data-urlencode 'midia=IMP'

Resposta (200):

{
    "success": true,
    "data": [
        {
            "id": 118109366,
            "data": "08/10/2026 14:23",
            "titulo": "Exemplo de título",
            "veiculo": "Nome do veículo",
            "abrangencia": "Nacional",
            "id_veiculo": 1234,
            "tier": "1",
            "nr_latitude": null,
            "nr_longitude": null,
            "resumo": "...",
            "midia": "Impresso",
            "conteudo": "...",
            "link_noticia": "http://dominio/mec/?n=118109366",
            "poster": "...",
            "vl_publicitario": null,
            "qt_espaco_cm": null,
            "qt_espaco_seg": null,
            "vl_espaco": null,
            "qt_publico": null,
            "in_destacar": "N",
            "categorias": [],
            "avaliacoes": []
        }
    ]
}

O conteúdo de data é o JSON montado pela procedure p_api_lista_noticia. Quando a busca não retorna nenhuma notícia, data vem null – trate null e lista vazia do mesmo jeito no cliente.

Erros:

HTTP message_error Quando acontece
400 Parâmetro sistema é obrigatório. O campo sistema não foi enviado.
401 Token de acesso ausente, expirado ou não reconhecido. Header Authorization ausente, token vencido ou revogado.
403 Acesso não autorizado a partir deste IP. O usuário tem restrição de IP e a origem não está autorizada.
405 Método não permitido. Use POST. A rota foi chamada com GET.

noticia/get

Devolve o detalhe de uma notícia: o texto gravado, veículo, data, url, categorias e flags de estado. Use para conferir se a matéria que já está na base está completa.

Método: POST

https://api.linearc.com.br/noticia/get/

Content-Type: application/x-www-form-urlencoded
Header: Authorization: Bearer <access_token>

Parâmetros:

Nome Descrição Formato Obrigatório
sistema Sigla do sistema (a mesma das outras rotas, ex.: mec). String Sim
cd_noticia id da notícia – é o valor ?n= do link_noticia que o noticia/lista devolve. O nome id também é aceito, por compatibilidade com a API antiga. Numérico Sim

Exemplo:

curl -X POST 'https://api.linearc.com.br/noticia/get/' \
  -H 'Authorization: Bearer <access_token>' \
  --data-urlencode 'sistema=mec' \
  --data-urlencode 'cd_noticia=118109366'

Resposta (200):

{
    "success": true,
    "data": {
        "id": 118109366,
        "data": "08/10/2026 14:23",
        "titulo": "Exemplo de título",
        "resumo": "...",
        "conteudo": "...",
        "qt_caracteres": 4321,
        "veiculo": "Nome do veículo",
        "id_veiculo": 1234,
        "tp_veiculo": "SIT",
        "midia": "Site",
        "editoria": "...",
        "autor": "...",
        "pagina": "001",
        "url": "http://fonte.com.br/a/materia",
        "link_noticia": "http://dominio/mec/?n=118109366",
        "conteudo_midia": null,
        "categorias": [
            {
                "id_categoria": 12,
                "no_categoria": "Clipping"
            }
        ],
        "st_noticia": "A",
        "in_chamada_capa": "N",
        "dt_cadastro": "08/10/2026 14:25",
        "cd_usuario": "b3.import"
    }
}

conteudo é o texto gravado, sem escape de HTML (só os caracteres de controle são limpos), então dá para comparar direto com a fonte. qt_caracteres ajuda a flagrar texto truncado. Matéria de TV e rádio vem sem conteudo, e categorias pode vir null quando a notícia não tem categoria – trate null e lista vazia do mesmo jeito.

Quando a notícia não existe ou não pertence ao sistema informado, a resposta é 200 com "data": null – a API nunca devolve conteúdo de outro cliente.

Erros:

HTTP message_error Quando acontece
400 Parâmetro sistema é obrigatório. O campo sistema não foi enviado.
400 Parâmetro cd_noticia é obrigatório. Nem cd_noticia nem id foram enviados.
400 Parâmetro cd_noticia inválido. O valor enviado não é numérico.
401 Token de acesso ausente, expirado ou não reconhecido. Header Authorization ausente, token vencido ou revogado.
403 Acesso não autorizado a partir deste IP. O usuário tem restrição de IP e a origem não está autorizada.
405 Método não permitido. Use POST. A rota foi chamada com GET.