Schema Display

Display REST API endpoint documentation with parameters, request/response bodies.

The SchemaDisplay component visualizes REST API endpoints with HTTP methods, paths, parameters, and request/response schemas.

See scripts/schema-display.tsx for this example.

Installation

npx ai-elements@latest add schema-display

Features

  • Color-coded HTTP methods
  • Path parameter highlighting
  • Collapsible parameters section
  • Request/response body schemas
  • Nested object property display
  • Required field indicators

Method Colors

MethodColor
GETGreen
POSTBlue
PUTOrange
PATCHYellow
DELETERed

Examples

Basic Usage

See scripts/schema-display-basic.tsx for this example.

With Parameters

See scripts/schema-display-params.tsx for this example.

With Request/Response Bodies

See scripts/schema-display-body.tsx for this example.

Nested Properties

See scripts/schema-display-nested.tsx for this example.

Props

<SchemaDisplay />

PropTypeDefaultDescription
methodunknown-HTTP method.
pathstring-API endpoint path.
descriptionstring-Endpoint description.
parametersSchemaParameter[]-URL/query parameters.
requestBodySchemaProperty[]-Request body properties.
responseBodySchemaProperty[]-Response body properties.

SchemaParameter

interface SchemaParameter { name: string; type: string; required?: boolean; description?: string; location?: "path" | "query" | "header"; }

SchemaProperty

interface SchemaProperty { name: string; type: string; required?: boolean; description?: string; properties?: SchemaProperty[]; // For objects items?: SchemaProperty; // For arrays }

Subcomponents

  • SchemaDisplayHeader - Header container
  • SchemaDisplayMethod - Color-coded method badge
  • SchemaDisplayPath - Path with highlighted parameters
  • SchemaDisplayDescription - Description text
  • SchemaDisplayContent - Content container
  • SchemaDisplayParameters - Collapsible parameters section
  • SchemaDisplayParameter - Individual parameter
  • SchemaDisplayRequest - Collapsible request body
  • SchemaDisplayResponse - Collapsible response body
  • SchemaDisplayProperty - Schema property (recursive)
  • SchemaDisplayExample - Code example block