> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter detalhes do pedido da plataforma AceDataCloud

> Platform API guide - Ace Data Cloud

Consulte um pedido pelo ID do pedido. Este endpoint oferece suporte a dois modos de leitura: o acesso anônimo retorna apenas os campos mínimos necessários para a página de pagamento; o proprietário do pedido que porta o Account Token recebe os detalhes completos.

## Visão geral da API

| Item | Conteúdo |
| - | - |
| Método | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/orders/{order_id}` |
| Autenticação | Opcional; anônimo recebe projeção mínima, proprietário autenticado recebe projeção completa |

`/orders/{id}` e `/orders/{id}/` estão disponíveis atualmente. O ID do pedido faz parte do link de pagamento e deve ser tratado como um identificador opaco sensível, não o divulgue publicamente.

## Consulta anônima

A página de pagamento pode ler diretamente quando o estado de login for perdido:

```shell theme={null}
export ORDER_ID='seu ID do pedido'
curl "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}" \
  -H 'Accept: application/json'
```

A resposta anônima inclui apenas `id`, `description`, `price`, `state`, `pay_way`, `pay_url`, `expired_at`, `created_at`. Ela não retorna identificadores internos de conta, Application, Package, pagamento ou metadata.

## Consulta autenticada

```shell theme={null}
export PLATFORM_TOKEN='seu token de conta'
curl "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"
```

O proprietário do pedido receberá os detalhes completos de Order, incluindo `application` / `applications`, `package` / `packages`, `bank_details`, `invoice_automation` e campos do modelo. Se estiver autenticado, mas não for o proprietário do pedido, retornará `403`; exceto para superadministradores.

## Campos principais

| Campo | Descrição |
| - | - |
| `state` | `Pending`, `Paid`, `Finished`, `Expired`, `Failed` ou `Refunded` |
| `pay_way` | Método de pagamento atual do pedido; o nome do campo não é `payment_method` |
| `pay_url` | Endereço da página de pagamento hospedada ou do código QR, pode estar vazio |
| `price` | Valor final a pagar pelo pedido; o modelo de pedido atual não fornece o campo `final_price` |
| `amount` | Quantidade de créditos do pacote; visível apenas na resposta completa autenticada |
| `finished_at` | Hora de conclusão do pedido; o nome do campo não é `paid_at` |

A resposta completa pode adicionar campos conforme o método de pagamento, os clientes devem ler conforme necessário e sempre evitar registrar metadata sensíveis na resposta completa.

## Tratamento de erros

* `404`: o ID do pedido não existe.
* `403`: está conectado, mas não é o proprietário do pedido.
* Solicitações anônimas não retornam `401`; elas recebem apenas a projeção pública mínima.

## APIs relacionadas

* [Obter lista de pedidos](https://platform.acedata.cloud/documents/platform-order-list)
* [Criar pedido de recarga](https://platform.acedata.cloud/documents/platform-order-create)
* [Pagar pedido](https://platform.acedata.cloud/documents/platform-order-pay)
* [Atualizar status do pedido](https://platform.acedata.cloud/documents/platform-order-refresh)


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