> ## 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.

# Recuperare i dettagli di un ordine sulla piattaforma AceDataCloud

> Platform API guide - Ace Data Cloud

Interroga un ordine tramite l'ID dell'ordine. Questo endpoint supporta due modalità di lettura: l'accesso anonimo restituisce solo i campi minimi richiesti dalla pagina di pagamento; il proprietario dell'ordine con Account Token restituisce i dettagli completi.

## Panoramica dell'interfaccia

| Voce | Contenuto |
| - | - |
| Metodo | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/orders/{order_id}` |
| Autenticazione | Facoltativa; anonimo per la proiezione minima, proprietario autenticato per la proiezione completa |

`/orders/{id}` e `/orders/{id}/` sono entrambi attualmente disponibili. L'ID dell'ordine fa parte del link di pagamento e deve essere considerato un identificatore opaco sensibile, non divulgarlo pubblicamente.

## Query anonima

La pagina di pagamento può leggere direttamente quando lo stato di accesso è perso:

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

La risposta anonima include solo `id`, `description`, `price`, `state`, `pay_way`, `pay_url`, `expired_at`, `created_at`. Non restituirà account, Application, Package, identificatori interni di pagamento o metadata.

## Query autenticata

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

Il proprietario dell'ordine riceverà i dettagli completi dell'Order, inclusi `application` / `applications`, `package` / `packages`, `bank_details`, `invoice_automation` e i campi del modello. Se autenticato ma non proprietario dell'ordine, restituisce `403`; tranne gli amministratori principali.

## Campi chiave

| Campo | Descrizione |
| - | - |
| `state` | `Pending`, `Paid`, `Finished`, `Expired`, `Failed` o `Refunded` |
| `pay_way` | Metodo di pagamento corrente dell'ordine; il nome del campo non è `payment_method` |
| `pay_url` | Indirizzo della pagina di pagamento ospitata o del codice QR, può essere vuoto |
| `price` | Importo finale dovuto per l'ordine; il modello dell'ordine corrente non fornisce il campo `final_price` |
| `amount` | Quantità della quota del pacchetto; visibile solo nella risposta completa autenticata |
| `finished_at` | Ora di completamento dell'ordine; il nome del campo non è `paid_at` |

La risposta completa può aggiungere campi a seconda del metodo di pagamento, i client devono leggerli secondo necessità e devono sempre evitare di registrare metadata sensibili nella risposta completa.

## Gestione degli errori

* `404`: l'ID dell'ordine non esiste.
* `403`: l'utente ha effettuato l'accesso ma non è il proprietario dell'ordine.
* Le richieste anonime non restituiscono `401`; ottengono solo la proiezione pubblica minima.

## Interfacce correlate

* [Recuperare l'elenco degli ordini](https://platform.acedata.cloud/documents/platform-order-list)
* [Creare un ordine di ricarica](https://platform.acedata.cloud/documents/platform-order-create)
* [Pagare un ordine](https://platform.acedata.cloud/documents/platform-order-pay)
* [Aggiornare lo stato dell'ordine](https://platform.acedata.cloud/documents/platform-order-refresh)


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