Consulta NIF

<h1>API de Consulta de NIF Empresas</h1>

<h2>Visão Geral</h2>
<p>A API de Consulta de NIF Empresas permite consultar dados de empresas angolanas através do Número de Identificação Fiscal (NIF).</p>

<h2>Funcionalidades</h2>
<ul>
    <li>Consulta de dados de empresas (nome, tipo)</li>
    <li>Respostas rápidas e confiáveis</li>
    <li>Cache integrado para melhor performance</li>
    <li>Integração simples e direta</li>
</ul>

<h2>Casos de Uso</h2>
<ul>
    <li>Verificação de dados de empresas</li>
    <li>Integração com sistemas de compras</li>
    <li>Validação de fornecedores</li>
    <li>Consulta rápida de informações empresariais</li>
</ul>

<h1>Endpoints Disponíveis</h1>

<h2>Consultar NIF de Empresa</h2>

<h3>Endpoint</h3>
<pre><code>GET /consultar/{nif}/nif</code></pre>

<h3>Parâmetros</h3>
<table>
    <thead>
        <tr>
            <th>Parâmetro</th>
            <th>Tipo</th>
            <th>Obrigatório</th>
            <th>Descrição</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>nif</td>
            <td>string</td>
            <td>Sim</td>
            <td>Número de Identificação Fiscal da empresa</td>
        </tr>
    </tbody>
</table>

<h3>Exemplo de requisição</h3>
<pre><code>curl -X GET "https://portfolio-joaotomas.test/api/gateway/consulta-nif/consultar/5410003144/nif" \
  -H "X-API-Key: sua-chave-aqui" \
  -H "Accept: application/json"</code></pre>

<h3>Resposta de sucesso</h3>
<pre><code>{
  "error": false,
  "name": "UNITEL, S.A",
  "type": "CONSULTA DE NIF"
}</code></pre>

<h3>Resposta de erro</h3>
<pre><code>{
  "error": true,
  "message": "Empresa não encontrada"
}</code></pre>