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

# Ottenere i dettagli di una richiesta di servizio della piattaforma AceDataCloud

> Platform API guide - Ace Data Cloud

Ottieni lo stato completo di una singola richiesta di servizio tramite Application ID: rispetto all'interfaccia elenco, aggiunge campi come l'oggetto completo `service` (inclusi i pacchetti `packages`), adatto alle pagine di dettaglio.

> ℹ️ Questa interfaccia appartiene alla **API di gestione della piattaforma AceDataCloud**, con prefisso unificato `https://platform.acedata.cloud/api/v1/`. Per l'indice completo delle interfacce, consulta [Ottenere l'elenco della documentazione della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-document-list).

## Panoramica dell'interfaccia

| Voce | Contenuto |
| - | - |
| Metodo | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/applications/{application_id}` |
| Autenticazione | ✅ Token dell'account richiesto |

Attualmente sono disponibili sia `/applications/{id}` sia `/applications/{id}/`; gli esempi utilizzano uniformemente la forma senza barra finale.

## Istruzioni di autenticazione (come ottenere il token dell'account)

Intestazione della richiesta:

```http theme={null}
Authorization: Bearer ${PLATFORM_TOKEN}
```

Per il metodo dettagliato di ottenimento, consulta [Gestire il token dell'account della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-token).

> ℹ️ A differenza dell'interfaccia elenco, **la verifica dei permessi dell'interfaccia di dettaglio viene eseguita direttamente sul singolo oggetto**, senza necessità di passare `?user_id=`. Tuttavia, se accedi alla richiesta di un'altra persona riceverai `403 permission_denied`.

## Parametri di percorso

| Parametro | Tipo | Obbligatorio | Descrizione |
| - | - | - | - |
| `application_id` | UUID | ✅ | Application ID |

## Esempi di richiesta

### cURL

```shell theme={null}
curl 'https://platform.acedata.cloud/api/v1/applications/82f57141-2323-4453-8730-60f7d833a2da' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"
```

### Python

```python theme={null}
import os
import requests

app_id = "82f57141-2323-4453-8730-60f7d833a2da"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/applications/{app_id}",
    headers={
        "accept": "application/json",
        "authorization": f"Bearer {os.environ['PLATFORM_TOKEN']}",
    },
    timeout=10,
)
app = resp.json()
print(f"Servizio: {app['service']['title']}")
print(f"Rimanenti {app['remaining_amount']} {app['service']['unit']} / utilizzati {app['used_amount']}")
```

### Node.js

```javascript theme={null}
const appId = '82f57141-2323-4453-8730-60f7d833a2da'
const r = await fetch(`https://platform.acedata.cloud/api/v1/applications/${appId}`, {
  headers: { authorization: `Bearer ${process.env.PLATFORM_TOKEN}` },
})
console.log(await r.json())
```

## Esempio di risposta (HTTP 200)

```json theme={null}
{
  "id": "82f57141-2323-4453-8730-60f7d833a2da",
  "service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
  "remaining_amount": 100.0,
  "used_amount": 12.34,
  "paid": true,
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "disabled": false,
  "allow_consume_global": false,
  "scope": "Individual",
  "type": "Usage",
  "expired_at": null,
  "tags": null,
  "metadata": null,
  "service": {
    "id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
    "alias": "openai",
    "title": "OpenAI",
    "type": "Api",
    "unit": "Credit",
    "free_amount": 1.0,
    "packages": [
      { "id": "...", "type": "Usage", "price": 10.0, "amount": 100.0 }
    ]
  },
  "created_at": "2026-04-26T07:52:27.462400Z",
  "updated_at": "2026-04-26T08:42:13.123456Z"
}
```

## Descrizione dei campi di risposta

Il significato dei campi è uguale a quello dell'[interfaccia elenco](https://platform.acedata.cloud/documents/platform-application-list), con l'aggiunta di:

| Campo | Tipo | Descrizione |
| - | - | - |
| `service` | object | Oggetto completo del servizio (inclusi i pacchetti `packages`, `unit`, `free_amount`), utilizzabile direttamente per il rendering del pannello dei dettagli del servizio |

## Gestione degli errori

| HTTP | code | Significato |
| - | - | - |
| 401 | `not_authenticated` | Token dell'account mancante |
| 403 | `permission_denied` | Questa Application non ti appartiene |
| 404 | `not_found` | L'Application non esiste o è stata eliminata |

## Suggerimenti pratici

* **Per il monitoraggio in batch, usare preferibilmente l'elenco**: dopo aver recuperato una volta l'elenco delle Application, valutare in base all'unità e alla soglia di ogni servizio, evitando di richiedere i dettagli uno per uno.
* **Quando è necessario visualizzare il numero di credenziali**: utilizzare l'[elenco delle credenziali API](https://platform.acedata.cloud/documents/platform-credential-list) filtrando per `application_id`.
* **Approccio di analisi per `disabled=true`**: controllare ticket / notifiche e-mail per verificare se il servizio è stato disattivato a causa di controllo dei rischi, insolvenza o chiamate non conformi; non può essere riattivato tramite API, è necessario contattare il servizio clienti.

## Interfacce correlate

* [Ottenere l'elenco delle richieste di servizio della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-application-list)
* [Creare una richiesta di servizio della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-application-create)
* [Impostare la condivisione del saldo globale per un'applicazione della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-application-consume-global)
* [Ottenere l'elenco delle credenziali API della piattaforma AceDataCloud](https://platform.acedata.cloud/documents/platform-credential-list)


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