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

# Points de terminaison

> Points de terminaison des produits exposés par les services publics, et formats de statut renvoyés.

<h2 id="endpoint">
  Endpoint
</h2>

Source : [src/cwsandbox/\_types.py:219](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L219)

```python theme={"system"}
class Endpoint(*, kind: EndpointKind | str, auth: EndpointAuth | str | None = None, request_timeout_seconds: int | None = None)
```

Point de terminaison de produit sur un service PUBLIC. Défini lors de la création.

HTTPS + OPEN : CoreWeave assure la terminaison TLS. La présence d’une URL dans
`Sandbox.service_urls` signifie que le nom d’hôte a été attribué, et non que
l’application est déjà à l’écoute. `auth` est requis.

TLS\_PASSTHROUGH : la plateforme transfère le trafic TLS au conteneur en fonction du SNI.
`auth` et `request_timeout_seconds` ne doivent pas être définis. La cible
attribuée est `host:port` dans `Sandbox.service_addresses`. Utilisez
l’hôte comme SNI TLS. Les certificats sont gérés par la charge de travail.

`request_timeout_seconds` est le délai côté serveur appliqué aux requêtes HTTPS sur
ce point de terminaison de produit (504 tant que la sandbox reste active). Il ne s’agit pas de
`Sandbox.run(request_timeout_seconds=...)`, qui correspond à l’échéance RPC
côté client. Ce client exige uniquement un `int` (ou `None`).

**Attributs**

* `auth` (`EndpointAuth | str | None`) : `OPEN` lorsque le type est HTTPS. Doit être omis en
  mode TLS passthrough.
* `request_timeout_seconds` (`int | None`) : nombre de secondes avant que la plateforme ne ferme une
  requête HTTPS en cours. `None` ou `0` sélectionne la
  valeur par défaut de la plateforme (15 s en mode sans serveur). Le serveur accepte
  `0` ou `[15, 900]`. Lors d’une création à partir d’un modèle, `0` remplace
  la valeur dès lors qu’il est présent et ne rétablit pas la valeur par défaut de la plateforme
  à la place du délai d’expiration du modèle. Ne doit pas être défini en mode TLS
  passthrough.

***

<h2 id="endpointauth">
  EndpointAuth
</h2>

Source : [src/cwsandbox/\_types.py:213](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L213)

```python theme={"system"}
class EndpointAuth
```

* `OPEN` = `'open'`

***

<h2 id="endpointkind">
  EndpointKind
</h2>

Source : [src/cwsandbox/\_types.py:206](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L206)

```python theme={"system"}
class EndpointKind
```

* `HTTPS` = `'https'`
* `TLS_PASSTHROUGH` = `'tls_passthrough'`

***

<h2 id="httpsendpointstatus">
  HttpsEndpointStatus
</h2>

Source : [src/cwsandbox/\_types.py:278](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L278)

```python theme={"system"}
class HttpsEndpointStatus(*, port: int, name: str, kind: EndpointKind, auth: EndpointAuth, url: str, request_timeout_seconds: int)
```

Point de terminaison HTTPS de produit appliqué, renvoyé dans `Sandbox.service_endpoints`.

`request_timeout_seconds` correspond au délai effectif appliqué côté serveur (15 si
la requête de création l’a omis ou a transmis `0`). `url` est vide lorsque l’API le masque
(bacs à sable à l’état terminal). Ne pas confondre avec `Sandbox.run(request_timeout_seconds=...)`.

***

<h2 id="tlspassthroughendpointstatus">
  TlsPassthroughEndpointStatus
</h2>

Source : [src/cwsandbox/\_types.py:303](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L303)

```python theme={"system"}
class TlsPassthroughEndpointStatus(*, port: int, name: str, kind: EndpointKind, address: str)
```

Point de terminaison TLS passthrough appliqué, renvoyé dans `Sandbox.service_addresses`.

`address` est au format `host:port`. Utilisez l’hôte comme SNI TLS. La charge de travail
gère ses propres certificats. Vide après l’arrêt.

***