> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar status

> Acompanhe o processamento de um contêiner antes de publicar.

Retorna o estado de processamento do contêiner. Consulte o campo `status_code`.

| Valor | Significado |
| - | - |
| `FINISHED` | Pronto para publicar |
| `IN_PROGRESS` | Ainda processando |
| `ERROR` | Falhou. O contêiner não pode ser publicado |
| `EXPIRED` | Passou do prazo sem ser publicado |
| `PUBLISHED` | Já foi publicado |

## Quando consultar

Para **imagem**, o contêiner costuma nascer `FINISHED` e a consulta é dispensável.

Para **vídeo e reel**, a consulta é obrigatória. A criação do contêiner responde antes de a Meta baixar o arquivo, então a falha só aparece aqui.

Consulte em intervalos de alguns segundos até sair de `IN_PROGRESS`.

## Publicar um contêiner com erro

Chamar `media_publish` com um contêiner em `ERROR` é recusado, e a mensagem explica a causa original:

```json theme={null}
{
  "error": {
    "message": "Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 2207076,
    "error_user_title": "Falha ao baixar a mídia.",
    "error_user_msg": "Falha ao baixar a mídia.: The media could not be fetched from the provided URL."
  }
}
```

Os campos `error_user_title` e `error_user_msg` trazem a descrição em português e são mais úteis que o `message`.


## OpenAPI

````yaml api-reference/instagram/specs/pub-status.json GET /ig/{creation_id}
openapi: 3.1.0
info:
  title: Datafy API — Consultar status do contêiner
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /ig/{creation_id}:
    get:
      summary: Consultar status do contêiner
      operationId: igStatusContainer
      parameters:
        - name: creation_id
          in: path
          required: true
          schema:
            type: string
          description: ID do contêiner, devolvido por `POST /ig/me/media`.
          example: '17900000000000002'
        - name: fields
          in: query
          schema:
            type: string
          description: Use `status_code` para acompanhar o processamento.
          example: status_code
      responses:
        '200':
          description: Operação aceita.
          content:
            application/json:
              example:
                status_code: FINISHED
                status: FINISHED
                id: '17900000000000002'
        '400':
          description: Erro retornado pela Meta.
          content:
            application/json:
              example:
                error:
                  message: Invalid parameter
                  type: OAuthException
                  code: 100
                  error_subcode: 2207076
                  error_user_title: Falha ao baixar a mídia.
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token do canal do Instagram, gerado no painel da Datafy. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.