> For the complete documentation index, see [llms.txt](https://docs.zapsign.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/requisicoes-para-documentos/adicionar-documento-base64-pdf.md).

# Adicionar documento base64 PDF

## Struct utilizada:

* [Signer](/facilitadores/sdks/sdk-em-java/classes-usadas/body/signer.md)
* [Base64Pdf](/facilitadores/sdks/sdk-em-go/structs/base64pdf.md)

## Sobre o base64:

Base64 é uma maneira simples de converter um arquivo em texto. Veja aqui uma definição mais completa <https://pt.wikipedia.org/wiki/Base64>. Assim, converter o arquivo em base64 e enviar como texto no corpo da requisição é mais fácil do que lidar com **multipart/form-data**, por exemplo.

Para testar a API, você pode converter manualmente seu PDF em base64 através de vários sites, como esse: <https://base64.guru/converter/encode/pdf>

Quando a API já estiver integrada em seu sistema, procure a função adequada na sua linguagem de programação que pode converter o arquivo em base64.

**Observação:** você deve enviar o parâmetro base64\_pdf apenas com a conversão do arquivo em base64. **Não** insira data:application/pdf;base64, na sua string.&#x20;

## Visão geral:

Na SDK em Go, temos o arquivo '**create\_doc\_frombase64pdf\_parameter\_test.go**' no diretório do projeto **SdkGo** na Zapsign! Confira o diretório clicando [aqui](<  https://github.com/ZapSign/SdkGo>).&#x20;

Ao entrar no projeto, podemos ver claramente que existe uma estrutura de testes automatizados para cada requisição da Zapsign na pasta "**tests**". Para acessar o teste de criação de um documento via base64 em '.pdf', basta navegar em **"tests/docs/create\_doc\_frombase64pdf\_parameter\_test.go".**

![](/files/pRhZcUSAgjeTwVBl6jVu)

Para que esse teste consiga ter um [retorno 200](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200) e com sucesso, precisamos de algumas configurações essenciais.

* Um API Token.&#x20;
  * Descubra como achar seu [API Token](https://docs.zapsign.com.br/).
  * [Adicione seu API Token no projeto](/facilitadores/sdks/sdk-em-go/definindo-configuracoes/adicionando-api-token.md)
* O Body da requisição
  * Navegue até "**models/base64.go"**
    * Configure como você quer que seu documento seja criado. Veja mais detalhes nesse link de como criar um [documento utilizando a API](https://docs.zapsign.com.br/documentos/criar-documento).

<figure><img src="/files/wYT0gfGbDwMdmBX1Qidj" alt=""><figcaption><p>Exemplo básico de um documento criado com o parâmetro base64_pdf </p></figcaption></figure>

Após toda a configuração do seu [API Token](https://docs.zapsign.com.br/), basta rodar o teste automatizado que o documento será criado com sucesso.&#x20;

<figure><img src="/files/zYLQVY9UMUCxfn9QFCFv" alt=""><figcaption><p>Teste automatizado concluído e documento criado com sucesso.</p></figcaption></figure>

Pronto! A requisição foi realizada com sucesso e um documento foi criado em sua conta!  Fácil, né? 😁

Ficou alguma dúvida ou tem alguma sugestão de melhoria? Nos contate [aqui](https://zapsign.com.br/contato/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/requisicoes-para-documentos/adicionar-documento-base64-pdf.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.