# 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 %}


---

# 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://docs.autentique.com.br/api/2/integracao/sandbox-testes.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.