API
Application Programming Interface (Interface de Programação de Aplicativos), é um conjunto de padrões que permite sua utilização para construção de outros aplicativos. No Portal da Transparência, são disponibilizados via API todas as consultas exibidas no site sem restrições e no formato JSON. Este considerado o formato mais aberto, flexível e de fácil reutilização.
Dados Abertos
O nosso Portal da Transparência segue recomendações e padrões descritos pela W3C (World Wide Web Consortium) e a Open Knowledge Foundation, importantes instituições regulamentadoras da Web.
Segundo a Open Knowledge Foundation, "dados são abertos quando qualquer pessoa pode livremente usá-los, reutilizá-los e redistribuí-los, estando sujeito a, no máximo, a exigência de creditar a sua autoria e compartilhar pela mesma licença".
Qual o Significado?
A definição de dado aberto da Open Definition, resume-se em:
- Disponibilidade
- A informação precisa estar disponível por inteiro e por um custo razoável de reprodução, preferencialmente por meio de download na Internet e também deve estar num formato conveniente e modificável.
- Redistribuição
- A informação precisa ser fornecida em condições que permitam a sua redistribuição e/ou reutilização, incluindo o cruzamento com outros conjuntos de dados.
- Universalidade
- Todos podem usar, reutilizar e redistribuir não havendo discriminação contra áreas de atuação, pessoas ou grupos (não são permitidas restrições como, por exemplo, "não comercial" ou "somente educacional" que impeçam o seu uso irestrito).
APIs
Listagem de Métodos da API
CONTRATOS
API - CONTRATOS
URL
transparencia.coitedonoia.al.gov.br/api/contratos.php
MÉTODO
GET
PARÂMETROS
* NÃO NESCESSITA DE PARÂMETRO OBRIGATÓRIO
PARÂMETROS
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano | INT INT (4) |
Ano do exercício a ser consultado. |
RETORNO
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano |
INT |
Ano do Contrato |
| data |
DATA |
Data do contrato. |
| numero |
VARCHAR |
N.º do Contrato |
| modalidade |
VARCHAR |
Modalidade da Licitação |
| objeto |
VARCHAR |
Objeto do Contrato |
| fornecedor |
VARCHAR |
Fornecedor do Contrato |
| cnpj |
VARCHAR |
CNPJ do fornecedor do contrato |
| vigencia_inicial |
DATA |
Data de Inicio do Contrato |
| vigencia_final |
DATA |
Data do Fim do Contrato |
| valor |
DECIMAL |
Valor do Contrato |
COMO USAR
URL utilizada:transparencia.coitedonoia.al.gov.br/api/contratos.php?ano=2024
{
"Contratos": [
{
"ano":2025,
"data":"2025-02-13",
"numero":"00008 / 2025",
"modalidade":"PREGÃO ELETRÔNICO",
"objeto":"AQUISIÇÃO DE MATERIAL DE CONSTRUÇÃO. ",
"fornecedor":"R F SILVA",
"cnpj":"09.181.638/0001-40",
"vigenciainicial":"2025-02-13",
"vigenciafinal":"2026-02-13",
"valor":"3.020.750,00"
},
{
"ano":2024,
"data":"2024-02-23",
"numero":"00007/2024",
"modalidade":"INEXIGIBILIDADE",
"objeto":"OBJETO: CONTRATAÇÃO DE SHOW ARTÍSTICO DE BRUNIN, REPRESENTADA SUA EMPRESÁRIA EXCLUSIVA, DAYANE LIVIA DE ALMEIDA MARTINS PRODUÇÕES (BRUNINN PRODUCOES), INSCRITA NO CNPJ NO47.459.484/0001-03, BANDA ACLAMADA PELA OPINIÃO PÚBLICA DA REGIÃO, QUE REALIZARÁ APRESENTAÇÃO ARTÍSTICA (SHOW), NO EVENTO DE CARNAVAL DE COITÉ DO NÓIA/AL, EM PRAÇA PÚBLICA, COM DURAÇÃO DE 2(DUAS) HORAS, EM 11/02/2024, CONFORME PROPOSTA DE PREÇOS EM ANEXO.",
"fornecedor":"DAYANE LIVIA DE ALMEIDA MARTINS PRODUÇÕES",
"cnpj":"47.459.484/0001-03",
"vigenciainicial":"2024-02-23",
"vigenciafinal":"2024-02-29",
"valor":"23.000,00"
},
]
}
LICITAÇÕES
API - LICITAÇÕES
URL
transparencia.coitedonoia.al.gov.br/api/licitacao.php
MÉTODO
GET
PARÂMETROS
* NÃO NESCESSITA DE PARÂMETRO OBRIGATÓRIO
PARÂMETROS
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano | INT INT (4) |
Ano do exercício a ser consultado. |
RETORNO
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano |
INT |
Ano do Licitação |
| numero |
VARCHAR |
N.º da Licitação |
| data |
DATA |
Data da Licitação. |
| hora |
VARCHAR |
Hora da realização da Licitação. |
| modalidade |
VARCHAR |
Modalidade da Licitação |
| objeto |
VARCHAR |
Objeto do Licitação |
| orgao |
VARCHAR |
Orgão Resposável pela Licitação |
| fase |
VARCHAR |
fase da Licitação |
COMO USAR
URL utilizada:transparencia.coitedonoia.al.gov.br/api/licitacao.php?ano=2024
{
"Licitações": [
{
"ano":2026,
"numero":"003/2026",
"data":"2026-05-18",
"hora":"09:00",
"modalidade":"CONCORRÊNCIA PÚBLICA",
"objeto":"CONTRATAÇÃO DE PESSOA JURÍDICA PARA EXECUÇÃO DE OBRAS DE CONSTRUÇÃO ESPAÇO ESPORTIVO COMUNITÁRIO VINCULADO AO TERMO DE COMPROMISSO Nº 988070/2025/MESP/CAIXA.",
"orgao":"SECRETARIA DE OBRAS E SERVIÇOS URBANOS",
"fase":"Publicado"
},
{
"ano":2026,
"numero":"001/2026",
"data":"2026-03-20",
"hora":"10:00",
"modalidade":"CONCORRÊNCIA PÚBLICA",
"objeto":"Aquisição de gêneros alimentícios da Agricultura Familiar e do Empreendedor Familiar Rural, para o atendimento ao Programa Nacional de Alimentação Escolar – PNAE, para atender as demandas das creches, educação infantil, ensino fundamental e ensino de jovens e adultos, conforme condições, quantidades e exigências estabelecidas",
"orgao":"SECRETARIA DE EDUCAÇÃO",
"fase":"Publicado"
},
]
}
SERVIDORES
API - SERVIDORES
URL
transparencia.coitedonoia.al.gov.br/api/servidores.php
MÉTODO
GET
PARÂMETROS
* NÃO NESCESSITA DE PARÂMETRO OBRIGATÓRIO
PARÂMETROS
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano | INT INT (4) |
Ano corresponde da folha de pagamento. |
| mes | INT INT (2) |
Mês corresponde da folha de pagamento. |
RETORNO
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| nome |
VARCHAR |
Nome do servidor |
| cpf |
VARCHAR |
CPF do servidor |
| cargo |
VARCHAR |
Cargo do servidor |
| regime |
VARCHAR |
Vínculo do servidor |
| orgao |
VARCHAR |
Lotação em que se econtra o servidor |
| bruto |
DECIMAL |
Remuneração bruta do servidor |
| liquido |
DECIMAL |
Remuneração líquida do servidor |
| mes |
VARCHAR |
Mês de referência |
| ano |
VARCHAR |
Ano de referência |
COMO USAR
URL utilizada:transparencia.coitedonoia.al.gov.br/api/servidores.php?ano=2020&mes=6
"Servidores": [
{
"id": 33461,
"matricula": "314",
"nome": "ADALBERTO LOURENCO SILVA",
"cpf": "###.369.2##-##",
"cargo": "ASSIST ADM EDUCACIONAL N-II (L) 30",
"funcao": "ASSIST ADM EDUCACIONAL N-II (L) 30",
"regime": "EFETIVO",
"orgao": "SEC DE FINANCAS - EFETIVOS",
"centro_custo": "SEC DE FINANCAS - EFETIVOS",
"data_admissao": null,
"horas_semanais": "0",
"salario_base_valor": 6761.08,
"beneficios_valor": 0,
"inss_valor": 0,
"ir_valor": 0,
"outros_descontos_valor": 1216.37,
"bruto_valor": 6761.08,
"descontos_valor": 1216.37,
"liquido_valor": 5544.71,
"salario_base": "6.761,08",
"beneficios": "0,00",
"inss": "0,00",
"ir": "0,00",
"outros_descontos": "1.216,37",
"bruto": "6.761,08",
"descontos": "1.216,37",
"liquido": "5.544,71",
"mes": 3,
"mes_nome": "Março",
"ano": 2026,
"data_referencia": "2026-03-01 00:00:00"
},
{
"id": 33527,
"matricula": "450",
"nome": "ADEILSON VALERIANO DA SILVA",
"cpf": "###.395.5##-##",
"cargo": "AGENTE COMUNITARIO DE SAUDE",
"funcao": "AGENTE COMUNITARIO DE SAUDE",
"regime": "EFETIVO",
"orgao": "SEC DE SAUDE ACS - EFETIVOS",
"centro_custo": "SEC DE SAUDE ACS - EFETIVOS",
"data_admissao": null,
"horas_semanais": "0",
"salario_base_valor": 4688.55,
"beneficios_valor": 0,
"inss_valor": 0,
"ir_valor": 0,
"outros_descontos_valor": 521.96,
"bruto_valor": 4688.55,
"descontos_valor": 521.96,
"liquido_valor": 4166.59,
"salario_base": "4.688,55",
"beneficios": "0,00",
"inss": "0,00",
"ir": "0,00",
"outros_descontos": "521,96",
"bruto": "4.688,55",
"descontos": "521,96",
"liquido": "4.166,59",
"mes": 3,
"mes_nome": "Março",
"ano": 2026,
"data_referencia": "2026-03-01 00:00:00"
},
LEGISLAÇÃO
API - LICITAÇÃO
URL
transparencia.coitedonoia.al.gov.br/api/legislacao.php
MÉTODO
GET
PARÂMETROS
* NÃO NESCESSITA DE PARÂMETRO OBRIGATÓRIO
PARÂMETROS
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| ano | INT INT (4) |
Ano do exercício a ser consultado. |
RETORNO
| NOME | TIPO | DESCRIÇÃO |
|---|---|---|
| tipo |
VARCHAR |
Tipo de Legislação |
| ano |
INT |
Ano da Legislação |
| legislacao |
VARCHAR |
N.º da Legislação |
| descricao |
VARCHAR |
Descrição/Ementa da Legislação |
| data |
DATA |
Objeto do Legislação |
COMO USAR
URL utilizada:transparencia.coitedonoia.al.gov.br/api/legislacao.php?ano=2025
{
"legislacao": [
{
"tipo": "Leis Ordinárias",
"ano": 2024,
"legislacao": "0471",
"descricao": "Estima a receita e fixa a despesa do município para o exercício financeiro de 2025, e adota outras providências correlatas.",
"data": "2024-11-27"
},
{
"tipo": "Leis Ordinárias",
"ano": 2024,
"legislacao": "0468",
"descricao": "Dispõe sobre a lei de diretrizes orçamentárias para elaboração e execução do orçamento para o exercício financeiro de 2025, e dá outras providências.\r\n",
"data": "2024-07-19"
},
{
"tipo": "Portarias",
"ano": 2023,
"legislacao": "0016",
"descricao": "Institui o Programa Municipal de Lavagem de Mãos e Higiene para crianças e adolescentes na pré-escola e séries inicias do ensino fundamental.",
"data": "2023-06-27"
},
]
}