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

# Elenca Domini

> Elenca tutti gli hostname configurati nelle tue applicazioni, incluso il sottodominio predefinito squareweb.app e qualsiasi dominio personalizzato associato. Ha un limite di 20 richieste ogni 60 secondi.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La chiave API del tuo account. Puoi trovarla nelle [impostazioni del tuo account](https://squarecloud.app/it/account/security).
</ParamField>

<Note>
  Questo endpoint accetta la tua chiave API oppure un token di sessione (JWT) nell'header `Authorization`. L'autenticazione è obbligatoria: le richieste che ne sono prive restituiscono `401`.
</Note>

### Risposta

<ResponseField name="status" type="string">
  Indica se la chiamata è andata a buon fine. `success` in caso di successo, `error` in caso contrario.
</ResponseField>

L'array `response` è un elenco appiattito di ogni hostname nelle applicazioni di tua proprietà. I domini personalizzati compaiono per primi, seguiti dai sottodomini predefiniti `*.squareweb.app`. Le applicazioni senza un dominio web (ad esempio worker e bot) vengono omesse.

<Info>
  Questo elenco viene servito dalla lista dei progetti in cache, quindi **non** viene conteggiato nei limiti di rate di rete per applicazione.
</Info>

<ResponseField name="response" type="array">
  L'elenco degli hostname.

  <Expandable title="Mostra oggetto">
    <ResponseField name="app_id" type="string">
      L'identificatore esadecimale di 24 caratteri dell'applicazione proprietaria del dominio.
    </ResponseField>

    <ResponseField name="hostname" type="string">
      L'hostname completo (fully qualified).
    </ResponseField>

    <ResponseField name="type" type="string">
      `"subdomain"` per l'host predefinito `*.squareweb.app`; `"custom"` per un dominio personalizzato associato.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": [
      { "app_id": "abc123def456abc123def456", "hostname": "example.com", "type": "custom" },
      { "app_id": "abc123def456abc123def456", "hostname": "my-app.squareweb.app", "type": "subdomain" }
    ]
  }
  ```
</ResponseExample>