> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/integracao/sandbox-testes.md).

# Sandbox/testes

Para contextualizar, recomendamos que você leia como funciona a criação e a listagem de documentos primeiro:

{% content-ref url="/pages/-LsYgNLWMNqAlDnd53uc" %}
[Criando um Documento](/api/2/mutations/criando-um-documento.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LsYgEpXilJyyGsfTnN1" %}
[Resgatando Documentos](/api/2/queries/resgatando-documentos.md)
{% endcontent-ref %}

### Criando documentos *sandbox*

A criação de documentos teste depende apenas de um atributo a ser informado no documento: "**sandbox**".

```javascript
mutation CreateDocumentMutation(
  ...
) {
  createDocument(
    sandbox: true,
    document: $document,
    signers: $signers,
    file: $file
  ) {
  ...
  }
}
```

Feito! Os documentos criados com **sandbox** não irão gastar créditos porém, por serem de teste, serão excluídos após alguns dias.

Enquanto eles não forem excluídos, você poderá vê-los nas listagens de documentos do painel se você ativar na página de [chaves de API](https://painel.autentique.com.br/perfil/api):

![](/files/-LzJ1O-982xT2b_xmIlQ)

### Resgatando documentos *sandbox*

Assim como no painel, a listagem de documentos não retorna por padrão documentos que foram criados em *sandbox*. Para isso, existem duas flags que habilitam esse comportamento.

#### Habilitando a listagem de documentos *sandbox*

Para permitir que a listagem de documentos também retorne documentos que foram criados no modo *sandbox*, é necessário passar a flag `showSandbox` nos parâmetros da *query*:

```graphql
query {
  documents(
    limit: 60, 
    page: 1,
    showSandbox: true
  ) {
  ...
  }
}
```

#### Listando exclusivamente documentos *sandbox*

Também é possível buscar **apenas** por documentos que foram criados em *sandbox*. Para isso, basta passar a flag `onlySandbox` nos parâmetros da *query.*

```graphql
query {
  documents(
    limit: 60, 
    page: 1,
    onlySandbox: true
  ) {
  ...
  }
}
```

{% hint style="info" %}
Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do [Altair](https://altair.autentique.com.br). Se você não sabe como fazer isso, confira o nosso tutorial em [Usando o Altair](/api/2/integracao/altair.md)
{% endhint %}

{% hint style="warning" %}
Caso você esteja em dúvida de como funciona o envio do documento para usar na sua integração, este repositório fornece mais informações e exemplos de como fazer o upload: <https://github.com/jaydenseric/graphql-multipart-request-spec>
{% endhint %}

{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
Para importar e usar no Postman
{% endfile %}