# Requisição da API

### Execução&#x20;

O arquivo ZIP contém dois executáveis, ambos x64, um para Windows e outro para Linux.&#x20;

Para ver as opções, informe o parâmetro **-help**&#x20;

Se existir o arquivo **emissor\_soluti.json** na mesma pasta onde ele for executado, ele será usado como configuração.&#x20;

Se ativar o modo servidor, uma API REST será disponibilizada. Utilize somente conexões locais, ou configure conexão segura se desejar expor para algum outro servidor na rede.&#x20;

### Requisição REST&#x20;

Apenas um endpoint na raiz (por exemplo, [**http://localhost:8090/**](http://localhost:8090/)) é disponibilizado, somente com o método **POST**.&#x20;

Faça chamadas sucessivas com os mesmos dados para acompanhar o andamento do processo de emissão.&#x20;

Ao final, o arquivo **PFX** do certificado digital estará salvo no local indicado na configuração. O arquivo **PFX** não é retornado via **API REST.**&#x20;

Método das requisições: **POST**&#x20;

#### Header:&#x20;

```
Content-Type: application/json 
```

#### Body da requisição

```json
{ 
    "username": "3501220323615FDE 49782873000192", 
    "password": "<SENHA DE EMISSÃO>", 
    "pfx_password": "<SENHA do ARQUIVO PFX 123>" 
} 
```

O parâmetro **pfx\_password** é opcional. Se não informado, o arquivo PFX será criado com a mesma senha **password**. Se informado, deve ter pelo menos 8 caracteres, contendo letras minúsculas, maiúsculas e números, podendo conter também caracteres especiais.&#x20;

#### &#x20;Exemplo com cURL:&#x20;

```json
curl --location --request POST 'http://<ENDPOINT DA API>' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ 
    "username": "3501220323615FDE 49782873000192", 
    "password": "<SENHA DE EMISSÃO>", 
   "pfx_password": "<SENHA do ARQUIVO PFX 123>" 
}' 
```

**Veja exemplos de respostas da API:**

{% content-ref url="/pages/FG4bklSy22yFzB25LKnF" %}
[Fluxo de respostas da API](/emissor-soluti-em-go-como-funcao-aws-lambda/integracao-api/markdown/fluxo-de-respostas-da-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/ENsfk1a1AturrWdL8bdD" %}
[Possíveis erros](/emissor-soluti-em-go-como-funcao-aws-lambda/integracao-api/markdown/possiveis-erros.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuais.soluti.com.br/emissor-soluti-em-go-como-funcao-aws-lambda/integracao-api/markdown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
