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

# Protobuf

> Trouvez les définitions Protobuf de CoreWeave Sandboxes, l’hôte qui expose chaque service et les SDK générés.

Les définitions Protobuf de l’API CoreWeave Sandboxes se trouvent dans le module Buf [`buf.build/coreweave/sandbox`](https://buf.build/coreweave/sandbox). Utilisez-les pour une intégration depuis un langage qui ne dispose d’aucun client CoreWeave officiel, ou lorsque vous avez besoin d’un RPC que le [client Python](/fr/products/sandboxes/client) ou le client TypeScript (`@coreweave/cwsandbox`) n’expose pas.

La [page du module](https://buf.build/coreweave/sandbox) fait référence pour l’API elle-même : chaque service et chaque champ, les règles d’encodage JSON et le contrat d’erreur. Utilisez `coreweave.sandbox.v1` pour les nouvelles intégrations. L’ancien paquet `coreweave.sandbox.v1beta2` reste disponible pour les clients existants et prend également en charge les modèles de profil et l’enregistrement des exécuteurs.

<h2 id="endpoints">
  Points de terminaison
</h2>

Chaque RPC est servi via le [protocole Connect](https://connectrpc.com/), et les mêmes points de terminaison acceptent les clients gRPC et gRPC-Web. Les services `v1` sont répartis entre deux hôtes, auxquels s’ajoute un point de terminaison propre à chaque sandbox pour les connexions directes :

| Hôte | Services exposés |
| - | - |
| `https://api.cwsandbox.com` | `SandboxService`, `DiscoveryService`, `VolumeService`, `NetworkService` et `SettingsService`. |
| `https://api.coreweave.com` | `RunnerManagementService` et `SandboxTemplateService`. `PlacementOrgConfigService` est également exposé ici, réservé aux opérateurs de la plateforme. Voir l’[aperçu de l’API](/fr/products/sandboxes/reference/control-plane-api). |
| Point de terminaison du plan de données propre à chaque sandbox | `SandboxDataPlaneService`. `SandboxService.ConnectSandbox` renvoie l’URI du point de terminaison, un certificat client de courte durée et un bundle de certificats de confiance. Voir [Connexions directes aux sandboxes](/fr/products/sandboxes/client/guides/direct-connections). |

`NetworkService` n’est pas encore disponible : tous ses RPC renvoient `UNIMPLEMENTED`. Plus généralement, les RPC ne sont pas tous activés pour toutes les organisations ni pour tous les [modes de placement](/fr/products/sandboxes/placement#compare-placement-modes). Un appel non disponible renvoie `UNIMPLEMENTED` avec le motif `CWSANDBOX_NOT_IMPLEMENTED`.

Les requêtes s’authentifient à l’aide d’un jeton d’accès à l’API CoreWeave. Pour savoir comment en créer un et accorder l’action IAM `SANDBOX_USER` ou `SANDBOX_ADMIN`, voir [Authentification](/fr/products/sandboxes/reference/control-plane-api#authentication).

<h2 id="install-a-generated-sdk">
  Installer un SDK généré
</h2>

Le Buf Schema Registry génère à la demande des SDK pour le module. Les commandes suivantes installent les combinaisons de langages et de plugins les plus courantes :

```bash title="Install a generated SDK" theme={"system"}
# Go : clients Connect et types de messages
go get buf.build/gen/go/coreweave/sandbox/connectrpc/go@latest
go get buf.build/gen/go/coreweave/sandbox/protocolbuffers/go@latest

# Python : types de messages et stubs gRPC
pip install coreweave-sandbox-protocolbuffers-python coreweave-sandbox-grpc-python \
  --extra-index-url https://buf.build/gen/python

# TypeScript : types de messages, à utiliser avec @connectrpc/connect
npm config set @buf:registry https://buf.build/gen/npm/v1/
npm install @buf/coreweave_sandbox.bufbuild_es
```

Pour toute autre combinaison de langage et de plugin, consultez l’[onglet SDKs](https://buf.build/coreweave/sandbox/sdks) sur la page du module. Pour générer plutôt le code localement, indiquez le module à `buf generate` : `buf generate buf.build/coreweave/sandbox`.

<h2 id="see-also">
  Voir aussi
</h2>

* [Architecture des sandboxes](/fr/products/sandboxes/architecture) : comment la passerelle relaie les requêtes du runtime, et comment s’articule la séparation entre plan de contrôle et plan de données.
* [Aperçu de l’API](/fr/products/sandboxes/reference/control-plane-api) : authentification, pagination, masques de champs et gestion des erreurs pour le plan de contrôle.
* [Client Python des sandboxes](/fr/products/sandboxes/client) : le client `cwsandbox` de plus haut niveau, construit sur cette API.
* [Connexions directes aux sandboxes](/fr/products/sandboxes/client/guides/direct-connections) : comment un client accède à `SandboxDataPlaneService` via TLS mutuel.