a6-plugin-grpc-transcode

Configure the grpc-transcode plugin for APISIX routes via a6 CLI.

1|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/api7/a6 --skill a6-plugin-grpc-transcode-api7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a6-plugin-grpc-transcode
Source: https://github.com/api7/a6/tree/main/skills/a6-plugin-grpc-transcode
Command: npx skills add https://github.com/api7/a6 --skill a6-plugin-grpc-transcode-api7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building and exposing RESTful endpoints for gRPC services typically requires manual protobuf management and complex plumbing. This skill streamlines the setup by guiding you through configuring the Apache APISIX grpc-transcode plugin via the a6 CLI, bridging REST/HTTP requests to gRPC.

Core Features & Use Cases

  • Transcode REST/HTTP requests to gRPC calls using a pre-uploaded protobuf definition.
  • Proto file management with a6 proto create/list/get/delete to keep definitions in sync.
  • pb_option settings to control JSON encoding/decoding of enums, int64s, and defaults.
  • Decode gRPC error details into human-readable JSON for easier troubleshooting.
  • Common patterns: mapping routes to services, handling deadlines, and verbose logging for observability.

Quick Start

Upload a protobuf definition and attach it to an APISIX route using a6 to start transcoding.

Frequently Asked Questions about a6-plugin-grpc-transcode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcode REST HTTP requests to gRPC using APISIX?

You transcode REST to gRPC in APISIX by configuring the grpc-transcode plugin on a route, which requires uploading a protobuf definition and attaching it to map HTTP requests to upstream gRPC services.

What is gRPC transcoding and when do I need it for my APIs?

gRPC transcoding bridges REST/HTTP requests to gRPC calls. You need it when exposing gRPC services to REST clients, eliminating manual protobuf management and complex plumbing for protocol translation.

How do I manage protobuf definitions for APISIX grpc-transcode?

Manage protobuf definitions using proto file operations to create, list, get, and delete them. This ensures your proto files stay in sync with the grpc-transcode plugin configuration on APISIX routes.

Can I control JSON serialization of enums and int64s during gRPC transcoding?

Yes, you can control JSON encoding and decoding behaviors by tuning pb_option flags. This ensures proper data serialization for enums, int64s, and defaults when translating between REST and gRPC.

How do I decode gRPC error details into readable JSON for troubleshooting?

Decode gRPC error details into human-readable JSON by configuring the error decoding settings within the grpc-transcode plugin, making it easier to troubleshoot REST to gRPC translation issues.