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

# Dettaglio chiamata upstream

> Leggi il payload completo di request e response di una chiamata upstream.

**`GET`** `https://api-datahub.octoparse.com/v1/runs/{run_id}/upstream-calls/{call_id}`

Autenticazione: API key obbligatoria; solo l’autore (publisher) può chiamarlo. Tutti gli altri ricevono `404`.

Registrazione completa di una voce del trail: richiesta (query / body) e body della risposta. I body di risposta troppo grandi vengono troncati in scrittura; vedi `response_truncated`. Le regole di autenticazione sono le stesse dell'endpoint di elenco.

## Richiesta

### Parametri di percorso

<ParamField path="run_id" type="string" required>
  ID run di debug.
</ParamField>

<ParamField path="call_id" type="integer" required>
  ID della voce del trail, da `items[].call_id` dell'endpoint di elenco.
</ParamField>

### Esempio di richiesta

```bash theme={null}
curl \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  "https://api-datahub.octoparse.com/v1/runs/run_c62bc0fb8df2/upstream-calls/1"
```

## Risposta

### 200 successo

```json theme={null}
{
  "data": {
    "call_id": 0,
    "attempt": 0,
    "seq": 0,
    "stage": "string",
    "method": "string",
    "url": "string",
    "status_code": 0,
    "error": "string",
    "duration_ms": 0,
    "response_truncated": false,
    "created_at": "string",
    "request": {},
    "response_body": "string"
  }
}
```

Il payload è wrappato in `data`. Campi:

<ResponseField name="call_id" type="integer" required>
  —
</ResponseField>

<ResponseField name="attempt" type="integer" required>
  —
</ResponseField>

<ResponseField name="seq" type="integer" required>
  —
</ResponseField>

<ResponseField name="stage" type="string" required>
  —
</ResponseField>

<ResponseField name="method" type="string" required>
  —
</ResponseField>

<ResponseField name="url" type="string" required>
  —
</ResponseField>

<ResponseField name="status_code" type="integer">
  —
</ResponseField>

<ResponseField name="error" type="string">
  —
</ResponseField>

<ResponseField name="duration_ms" type="integer">
  —
</ResponseField>

<ResponseField name="response_truncated" type="boolean">
  Se il body della response è stato troncato in scrittura.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  —
</ResponseField>

<ResponseField name="request" type="object">
  Contenuto della richiesta (query / headers / body; valori sensibili oscurati).
</ResponseField>

<ResponseField name="response_body" type="string">
  Body della response upstream.
</ResponseField>

### Errori

| HTTP | `code`                     | `category`  | Descrizione                                                                                                                                                                           |
| ---- | -------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401  | `unauthorized`             | `forbidden` | API key mancante o non valida.                                                                                                                                                        |
| 404  | `upstream-calls-not-found` | `not_found` | Solo i run di debug (`run_kind=test`) conservano un trail delle chiamate upstream. I run di produzione, i run di altre persone e i run inesistenti restituiscono tutti questo errore. |

Le risposte di errore usano `{"error": {code, category, message, retryable}}`. Vedi <a href="/docs/it/datahub/api/reference/introduction#errors">Errori</a>.

## Librerie client

Gli SDK Python e JavaScript non wrappano ancora questo endpoint. Chiama REST direttamente.