Documentação de integração · swagger.json (OpenAPI 3.0)
https://api.linearc.com.br/{ "success": true, "data": [ ... ] }
{ "success": false, "data": [ { "error_code": "...", "message_error": "..." } ] }
aaaa-mm-ddThh:nn:ss) e recebidas como
aaaa-mm-dd (dd/mm/aaaa também é aceito).
swagger.json (OpenAPI 3.0.3)
descreve todas as rotas, parâmetros e respostas. Importe no Postman/Insomnia
ou abra no editor Swagger para gerar clientes; usar
Try it out exige informar o token no botão Authorize.
A API usa token de acesso enviado no header
Authorization: Bearer <token>. O token é obtido trocando uma
assinatura por um token temporário.
As chaves são geradas na área administrativa (Admin → TI → Usuários da API):
assinatura = hex( Hash( timestamp + chave_privada ) )
timestamp: Unix timestamp em segundos (UTC),
ex.: 1791481512.
Hash: SHA-256 (64 caracteres) ou MD5 (32 caracteres).1791481512A1B2C3...).
timestamp assinado deve ser enviado no corpo da requisição.
Exemplo em JavaScript:
var timestamp = Math.round(new Date().getTime() / 1000); var assinatura = CryptoJS.SHA256(timestamp + chavePrivada).toString();
https://api.linearc.com.br/auth/
Content-Type: application/x-www-form-urlencoded
| 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. |
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.
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": [] }
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.
Permissão de acesso negada para a rota .... O token continua
válido para as demais rotas liberadas.
não cadastrada ou inativa na API – nesse caso é preciso
falar com o suporte, porque nenhum usuário consegue chamá-la.
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.
https://api.linearc.com.br/noticia/lista/
Content-Type: application/x-www-form-urlencoded
Header: Authorization: Bearer <access_token>
| 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. |
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.
https://api.linearc.com.br/noticia/get/
Content-Type: application/x-www-form-urlencoded
Header: Authorization: Bearer <access_token>
| 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. |