# Adicionar documento base64 DOCX

## Struct utilizada:

* [Signer](https://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/structs/signer)
* [Base64Docx](https://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/structs/base64docx)

## 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="https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2FzAJh3GamJVto2W2zCf2v%2FCaptura%20de%20tela%20de%202023-02-09%2016-08-21.png?alt=media&#x26;token=7850db1d-26a8-4d92-af8e-0b42adf7db99" 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](https://docs.zapsign.com.br/facilitadores/sdks/sdk-em-go/definindo-configuracoes/adicionando-api-token)

* 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="https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2FlVevuNPQDfMsL94j4TaN%2FCaptura%20de%20tela%20de%202023-02-10%2016-15-04.png?alt=media&#x26;token=dc78eb2e-a061-4f1b-8820-ed001119789e" 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="https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2FldGYo6p3CbrKYwRT4LfE%2FCaptura%20de%20tela%20de%202023-02-09%2016-37-26.png?alt=media&#x26;token=0b315420-dd69-4b9b-b32f-ae3c3799b95f" 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/).