Перейти к основному содержимому

C#

Начните с руководства gRPC, чтобы создать токен API платформы и скачать platform.proto. Следующие команды запускайте из каталога с этим файлом.

Создайте консольный проект .NET:

dotnet new console -n ReconstructExample

Перейдите в каталог проекта:

cd ReconstructExample

Добавьте пакеты клиента gRPC:

dotnet add package Grpc.Net.Client
dotnet add package Grpc.Tools
dotnet add package Google.Protobuf

Скопируйте скачанный platform.proto в каталог ReconstructExample.

Добавьте этот элемент в .csproj проекта. Grpc.Tools генерирует клиент при сборке:

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

Используйте сгенерированные типы в Program.cs:

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 в него не входит.