📚 Documentação da API

🔗 Endpoint Base

URL alternativa: /api/index.php (funciona da mesma forma)

📖 Parâmetros de Consulta

Parâmetro	Tipo	Descrição	Exemplo
q	string	Busca textual no código ou descrição	?q=programação
codigo	string	Busca exata por código NBS	?codigo=010101

⚠️ Os parâmetros podem ser combinados para buscas mais específicas.

📤 Resposta da API

A API retorna um objeto JSON com a seguinte estrutura:

{
  "total": 189,
  "servicos": [
    {
      "codigo": "010101",
      "descricao": "Análise e desenvolvimento de sistemas."
    },
    {
      "codigo": "010201",
      "descricao": "Programação."
    }
  ]
}

🔍 Exemplos de Uso

1. Listar todos os serviços

GET https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/

2. Buscar por palavra-chave

GET https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?q=medicina

3. Buscar por código exato

GET https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?codigo=070101

4. Busca combinada

GET https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?q=engenharia&codigo=070101

🧪 Testar a API (Experimente agora!)

💻 Exemplos de Integração

JavaScript (Fetch)

fetch('https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?q=odontologia')
  .then(response => response.json())
  .then(data => {
    console.log(data.total, 'serviços encontrados');
    data.servicos.forEach(servico => {
      console.log(servico.codigo, '-', servico.descricao);
    });
  });

PHP (cURL)

<?php
$url = 'https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?q=fisioterapia';
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['servicos'] as $servico) {
    echo $servico['codigo'] . ' - ' . $servico['descricao'] . "\n";
}
?>

Python (requests)

import requests

response = requests.get('https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/', 
                        params={'q': 'contabilidade'})
data = response.json()
for servico in data['servicos']:
    print(f"{servico['codigo']} - {servico['descricao']}")

cURL (linha de comando)

curl "https://ferramentasdaweb.com.br/codigos-tributacao-nacional-nfse/api/?q=vigilância"

📋 Códigos de Resposta

Código	Descrição
200	OK - Requisição bem-sucedida
405	Method Not Allowed - Apenas GET é permitido
500	Erro interno do servidor

⚠️ Observações Importantes

• ✅ A API é pública e gratuita, sem necessidade de autenticação
• ✅ CORS habilitado - pode ser consumida diretamente de aplicações web
• ✅ Formato de resposta: JSON (UTF-8)
• ✅ Base de dados atualizada conforme Lei Complementar 116/2003
• 📊 Total de 189 serviços cadastrados na versão atual