> 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-docx.md).

# Adicionar documento base64 DOCX

## Struct utilizada:

* [Signer](/facilitadores/sdks/sdk-em-go/structs/signer.md)
* [Base64Docx](/facilitadores/sdks/sdk-em-go/structs/base64docx.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/decode/file>

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\_docx 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\_from\_base64docx\_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**".&#x20;

Para acessar o teste de criação de um documento com base64 em '.docx', basta navegar em **"tests/docs/create\_doc\_from\_base64docx\_parameter\_test.go".**

<figure><img src="/files/xtgXGJQdaagOABFoz2pi" alt=""><figcaption></figcaption></figure>

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 os dados de 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).

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

<figure><img src="/files/uLfE8F7ZknBj7OeG03lL" alt=""><figcaption><p>Exemplo de campos para a criação de um documento com base64 de um arquivo '.docx'</p></figcaption></figure>

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

Pronto! Um documento foi criado e a requisição foi realizada com sucesso!  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, and the optional `goal` query parameter:

```
GET https://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/requisicoes-para-documentos/adicionar-documento-base64-docx.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.