# C# {/* #c */}

首先阅读 [gRPC 指南](/docs/zh/api/grpc)，创建平台 API 令牌并下载 `platform.proto`。在包含此文件的目录中运行以下命令。

创建 .NET 控制台项目：

```bash
dotnet new console -n ReconstructExample
```

进入项目目录：

```bash
cd ReconstructExample
```

添加 gRPC 客户端包：

```bash
dotnet add package Grpc.Net.Client
```

```bash
dotnet add package Grpc.Tools
```

```bash
dotnet add package Google.Protobuf
```

将下载的 `platform.proto` 复制到 `ReconstructExample` 目录。

将以下项目添加至项目的 `.csproj` 文件。`Grpc.Tools` 会在构建时生成客户端：

```xml
<ItemGroup>
  <Protobuf Include="platform.proto" GrpcServices="Client" />
</ItemGroup>
```

在 `Program.cs` 中使用生成的类型：

```csharp
using Cr.Reconstruct.External.Grpc;
using Grpc.Core;
using Grpc.Net.Client;

var token = Environment.GetEnvironmentVariable("CR_RECONSTRUCT_API_TOKEN")
    ?? throw new InvalidOperationException("Set CR_RECONSTRUCT_API_TOKEN.");
var address = Environment.GetEnvironmentVariable("CR_RECONSTRUCT_GRPC_URL")
    ?? "https://reconstruct.dev";

using var channel = GrpcChannel.ForAddress(address);
var client = new PlatformService.PlatformServiceClient(channel);
var headers = new Metadata { { "authorization", $"Bearer {token}" } };
var page = await client.ListCatalogsAsync(
    new ListCatalogsRequest { PageSize = 10 }, headers, deadline: DateTime.UtcNow.AddSeconds(10));

foreach (var catalog in page.Catalogs)
{
    var detail = await client.GetCatalogAsync(
        new GetCatalogRequest { CatalogId = catalog.CatalogId }, headers);
    Console.WriteLine($"{detail.CatalogId}: {detail.Description}");
}
```

运行 `dotnet run`。原生 gRPC 通道使用 HTTPS 的主机和端口，不包含 REST 路径 `/api/v1/platform`。