# Lettura di una singola connessione

API per recuperare i dati di una specifica connessione dato il suo ID

<p class="callout info">[\[GET\] ​/api​/v3​/connections​/{connectionId}](https://connection-read-dev.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API%20V3/getConnection)</p>

### Header

Gli header richiesti dalla chiamata sono gli [header standard di TSDigital](https://digital-docs.ts-paas.com/books/integrazione-e-utilizzo-api-tsdigital/page/linee-guida-generali-api-ts-digital "Linee guida Generali API TS-Digital").

Il `Content-Type` deve essere `application/json`

### Path Parameters

- **connectionId:** identificativo univoco della connessione da leggere

### Risposte

L'operazione è avvenuta con successo se e solo se il codice HTTP della risposta è `200`. Ogni altro codice di risposta indica uno stato di errore.

#### HTTP 200

La connessione è stata recuperata con successo.

Il body della risposta è un singolo [Link](https://digital-docs.ts-paas.com/link/109#bkmrk-link "Link model") contenente la sola connessione richiesta:

```JSON
{
  "id": "string",
  "managerId": "string",
  "managedId": "string",
  "managerDescription": "string",
  "managedDescription": "string",
  "connections": [
    {
      "id": "string",
      "status": {
        "active": true,
        "activatedAt": "2020-09-10T13:49:33.092Z",
        "activatedBy": "string",
        "createdAt": "2020-09-10T13:49:33.092Z",
        "createdBy": "string",
        "modifiedAt": "2020-09-10T13:49:33.092Z",
        "modifiedBy": "string",
        "deleted": true,
        "deletedAt": "2020-09-10T13:49:33.092Z",
        "deletedBy": "string",
        "status": "string",
        "certificationStatus": "string"
      },
      "appId": "string",
      "featureCode": "string",
      "permission": "string",
      "approvalType": "string",
      "serviceId": "string"
    }
  ]
}
```

<span style="color: #222222; font-size: 1.666em; font-weight: 400;">HTTP 400</span>

Uno o più parametri forniti nella richiesta sono errati, o mancano dei parametri obbligatori.

#### HTTP 401

Il token autorizzativo è scaduto, invalido o non è stato specificato.

#### HTTP 403

Il token autorizzativo fornito è valido, ma l'utente non ha i permessi necessari a creare una connessione per il gestore specificato.

#### HTTP 500

Il server ha riscontrato un errore inaspettato nella creazione della richiesta di connessione

#### HTTP 502

Il server ha riscontrato un errore inaspettato nel comunicare con un servizio dal quale dipende per poter completare il processo (ad esempio, il servizio di auth non risulta essere disponibile)

Tutte le risposte d'errore condividono il seguente formato per il body di risposta:

```JSON
{
  "code": "string",
  "message": "string",
  "status": "string",
  "subErrors": [
    {}
  ],
  "timestamp": "dd-MM-yyyy HH:mm:ss"
}
```

- **code:** corrisponde al codice d'errore HTTP ritornato (es: `409`)
- **message:** messaggio d'errore (es: `Impossibile creare una connessione gia' esistente`)
- **status:** descrizione a parole del codice d'errore HTTP (es: `Conflict`)
- **subErrors:** eventuali errori innestati in quello ritornato
- **timestamp:** data ed ora di ritorno dell'errore