Api Documentation Page

blockdevops

Stripe and Mintlify style two-pane API documentation reference page with HTTP method badge, endpoint path, headers, request parameter tables with nested schema hints, response attributes, interactive multi-language code snippets (cURL, Node.js, Python, Go, Ruby), and status response tabs with copy actions.

Also available for React ->

Installation

$pnpm dlx shadcn-vue@latest add https://uipkge.dev/r/vue/api-documentation-page.json

$npx shadcn-vue@latest add https://uipkge.dev/r/vue/api-documentation-page.json

$yarn dlx shadcn-vue@latest add https://uipkge.dev/r/vue/api-documentation-page.json

$bunx shadcn-vue@latest add https://uipkge.dev/r/vue/api-documentation-page.json

Named registry:npx shadcn-vue@latest add @uipkge/api-documentation-pageInstalls to:app/components/blocks/

Variants

Loading interactive previews…

Props

Name	Type / Values	Default	Required
`class`	`HTMLAttributes['class']`	—	optional

Schema

Type aliases exported from this item's source. Use these to shape the data you pass in.

HeaderItem

interface HeaderItem {
  name: string
  type: string
  required: boolean
  sample: string
  description: string
}

NestedParam

interface NestedParam {
  name: string
  type: string
  required: boolean
  description: string
  example?: string
}

BodyParam

interface BodyParam {
  name: string
  type: string
  required: boolean
  description: string
  example?: string
  nested?: NestedParam[]
}

ResponseAttr

interface ResponseAttr {
  name: string
  type: string
  description: string
  example: string
}

StatusPill

interface StatusPill {
  code: StatusKey
  label: string
  summary: string
  dotColor: string
}

npm dependencies

lucide-vue-next

Includes

badge button card separator table

Files installed (1)

app/components/blocks/ApiDocumentationPage.vue32.5 kB

<script setup lang="ts">
import { ref } from 'vue'
import type { HTMLAttributes } from 'vue'
import { Check, Copy, CornerDownRight, Globe, Server, ShieldCheck, Terminal, Zap } from 'lucide-vue-next'
import { cn } from '@/lib/utils'
import { Badge } from '@/components/ui/badge'
import { Button } from '@/components/ui/button'
import { Card } from '@/components/ui/card'
import { Separator } from '@/components/ui/separator'
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'

interface Props {
  class?: HTMLAttributes['class']
}

const props = defineProps<Props>()

type LanguageKey = 'curl' | 'node' | 'python' | 'go' | 'ruby'
type StatusKey = '200' | '400' | '401'

const selectedLang = ref<LanguageKey>('curl')
const selectedStatus = ref<StatusKey>('200')
const copiedEndpoint = ref(false)
const copiedRequest = ref(false)
const copiedResponse = ref(false)

const endpointUrl = 'https://api.acme.com/v1/customers/subscriptions'
const endpointPath = '/v1/customers/subscriptions'

interface HeaderItem {
  name: string
  type: string
  required: boolean
  sample: string
  description: string
}

const headersList: HeaderItem[] = [
  {
    name: 'Authorization',
    type: 'string',
    required: true,
    sample: 'Bearer uipkge_live_51Msz...',
    description: 'Secret API key prefixed with uipkge_live_ or sk_test_. Pass in the HTTP Authorization header.',
  },
  {
    name: 'Content-Type',
    type: 'string',
    required: true,
    sample: 'application/json',
    description: 'Specifies the media type of the request body. Must be application/json.',
  },
  {
    name: 'Idempotency-Key',
    type: 'string (UUID)',
    required: false,
    sample: '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d',
    description: 'Unique client-generated key that prevents duplicate executions if a request is retried.',
  },
]

interface NestedParam {
  name: string
  type: string
  required: boolean
  description: string
  example?: string
}

interface BodyParam {
  name: string
  type: string
  required: boolean
  description: string
  example?: string
  nested?: NestedParam[]
}

const bodyParams: BodyParam[] = [
  {
    name: 'customer_id',
    type: 'string',
    required: true,
    description: 'Unique customer identifier for the subscriber. Must begin with the prefix cus_.',
    example: '"cus_N63vKZbI8O8yWp"',
  },
  {
    name: 'plan_id',
    type: 'string',
    required: true,
    description: 'Identifier of the subscription tier to enroll the customer into.',
    example: '"plan_pro_monthly"',
  },
  {
    name: 'items',
    type: 'array of objects',
    required: true,
    description: 'List of subscription line items defining the base plan and any optional recurring addons.',
    nested: [
      {
        name: 'items[].price_id',
        type: 'string',
        required: true,
        description: 'Unique price object identifier corresponding to a catalog product.',
        example: '"price_1Msz82eZvKYlo2C"',
      },
      {
        name: 'items[].quantity',
        type: 'integer',
        required: false,
        description: 'Unit quantity of the specified price item. Defaults to 1 if omitted.',
        example: '1',
      },
    ],
  },
  {
    name: 'payment_method_id',
    type: 'string',
    required: false,
    description: 'Attached payment method ID (pm_...) to charge. If omitted, uses the customer default payment source.',
    example: '"pm_1OdVq82eZvKYlo2C"',
  },
  {
    name: 'billing_cycle_anchor',
    type: 'integer (timestamp)',
    required: false,
    description: 'Future Unix timestamp that marks the beginning of recurring billing cycles.',
    example: '1717200000',
  },
  {
    name: 'trial_period_days',
    type: 'integer',
    required: false,
    description: 'Number of zero-charge trial days before regular billing begins (1 to 90).',
    example: '14',
  },
  {
    name: 'coupon_code',
    type: 'string',
    required: false,
    description: 'Valid discount or promotional coupon applied to initial invoices.',
    example: '"LAUNCH2026"',
  },
  {
    name: 'metadata',
    type: 'object',
    required: false,
    description: 'Arbitrary key-value map for attribution and custom IDs. Supports up to 50 keys, max 500 chars/value.',
    example: '{"referrer": "onboarding_flow"}',
  },
]

interface ResponseAttr {
  name: string
  type: string
  description: string
  example: string
}

const responseAttributes: ResponseAttr[] = [
  {
    name: 'id',
    type: 'string',
    description: 'Unique identifier for the subscription entity, prefixed with sub_.',
    example: '"sub_1Om48B2eZvKYlo2CqO8k2"',
  },
  {
    name: 'object',
    type: 'string',
    description: 'String representing the object type. Always subscription.',
    example: '"subscription"',
  },
  {
    name: 'customer',
    type: 'string',
    description: 'Customer identifier associated with this subscription record.',
    example: '"cus_N63vKZbI8O8yWp"',
  },
  {
    name: 'status',
    type: 'string',
    description: 'Current lifecycle status: trialing, active, past_due, canceled, unpaid, or incomplete.',
    example: '"trialing"',
  },
  {
    name: 'current_period_start',
    type: 'integer (timestamp)',
    description: 'Unix timestamp marking the start of the current active billing cycle.',
    example: '1717200000',
  },
  {
    name: 'current_period_end',
    type: 'integer (timestamp)',
    description: 'Unix timestamp marking the end of the current cycle and scheduled renewal date.',
    example: '1719792000',
  },
  {
    name: 'trial_end',
    type: 'integer (timestamp) | null',
    description: 'Unix timestamp when the free trial period concludes and billing begins.',
    example: '1718409600',
  },
  {
    name: 'cancel_at_period_end',
    type: 'boolean',
    description: 'If true, the subscription will terminate automatically at the end of the current period.',
    example: 'false',
  },
  {
    name: 'latest_invoice',
    type: 'string',
    description: 'Identifier of the most recent invoice generated for this subscription (in_...).',
    example: '"in_1Om48B2eZvKYlo2Cj891"',
  },
]

interface StatusPill {
  code: StatusKey
  label: string
  summary: string
  dotColor: string
}

const statusPills: StatusPill[] = [
  {
    code: '200',
    label: '200 OK',
    summary: 'Subscription created successfully. Returns full subscription entity.',
    dotColor: 'bg-success',
  },
  {
    code: '400',
    label: '400 Bad Request',
    summary: 'Missing required parameters or malformed JSON payload.',
    dotColor: 'bg-warning',
  },
  {
    code: '401',
    label: '401 Unauthorized',
    summary: 'Missing, expired, or invalid Bearer secret API key.',
    dotColor: 'bg-destructive',
  },
]

const requestSnippets: Record<LanguageKey, string> = {
  curl: `curl -X POST https://api.acme.com/v1/customers/subscriptions \\
  -H "Authorization: Bearer uipkge_live_51Msz..." \\
  -H "Content-Type: application/json" \\
  -H "Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" \\
  -d '{
    "customer_id": "cus_N63vKZbI8O8yWp",
    "plan_id": "plan_pro_monthly",
    "payment_method_id": "pm_1OdVq82eZvKYlo2C",
    "billing_cycle_anchor": 1717200000,
    "items": [
      {
        "price_id": "price_1Msz82eZvKYlo2C",
        "quantity": 1
      },
      {
        "price_id": "price_addon_seats_pro",
        "quantity": 5
      }
    ],
    "trial_period_days": 14,
    "coupon_code": "LAUNCH2026",
    "metadata": {
      "referrer": "onboarding_flow",
      "account_manager": "priya.raman"
    }
  }'`,
  node: `import Acme from '@acme/sdk'

const acme = new Acme({
  apiKey: process.env.ACME_SECRET_KEY,
})

const subscription = await acme.subscriptions.create({
  customerId: 'cus_N63vKZbI8O8yWp',
  planId: 'plan_pro_monthly',
  paymentMethodId: 'pm_1OdVq82eZvKYlo2C',
  billingCycleAnchor: 1717200000,
  items: [
    { priceId: 'price_1Msz82eZvKYlo2C', quantity: 1 },
    { priceId: 'price_addon_seats_pro', quantity: 5 },
  ],
  trialPeriodDays: 14,
  couponCode: 'LAUNCH2026',
  metadata: {
    referrer: 'onboarding_flow',
    accountManager: 'priya.raman',
  },
}, {
  idempotencyKey: '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d',
})

console.log(subscription.id)`,
  python: `import os
import acme

acme.api_key = os.environ.get("ACME_SECRET_KEY")

subscription = acme.Subscription.create(
    customer_id="cus_N63vKZbI8O8yWp",
    plan_id="plan_pro_monthly",
    payment_method_id="pm_1OdVq82eZvKYlo2C",
    billing_cycle_anchor=1717200000,
    items=[
        {"price_id": "price_1Msz82eZvKYlo2C", "quantity": 1},
        {"price_id": "price_addon_seats_pro", "quantity": 5},
    ],
    trial_period_days=14,
    coupon_code="LAUNCH2026",
    metadata={
        "referrer": "onboarding_flow",
        "account_manager": "priya.raman",
    },
    idempotency_key="9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
)

print(subscription.id)`,
  go: `package main

import (
	"context"
	"fmt"
	"os"

	"github.com/acme/acme-go"
)

func main() {
	client := acme.NewClient(os.Getenv("ACME_SECRET_KEY"))

	params := &acme.SubscriptionCreateParams{
		CustomerID:      acme.String("cus_N63vKZbI8O8yWp"),
		PlanID:          acme.String("plan_pro_monthly"),
		PaymentMethodID: acme.String("pm_1OdVq82eZvKYlo2C"),
		Items: []*acme.SubscriptionItemParams{
			{PriceID: acme.String("price_1Msz82eZvKYlo2C"), Quantity: acme.Int64(1)},
			{PriceID: acme.String("price_addon_seats_pro"), Quantity: acme.Int64(5)},
		},
		TrialPeriodDays: acme.Int64(14),
		CouponCode:      acme.String("LAUNCH2026"),
		Metadata: map[string]string{
			"referrer":        "onboarding_flow",
			"account_manager": "priya.raman",
		},
	}

	sub, err := client.Subscriptions.New(context.Background(), params)
	if err != nil {
		panic(err)
	}

	fmt.Printf("Created subscription: %s\\n", sub.ID)
}`,
  ruby: `require "acme"

Acme.api_key = ENV["ACME_SECRET_KEY"]

subscription = Acme::Subscription.create(
  {
    customer_id: "cus_N63vKZbI8O8yWp",
    plan_id: "plan_pro_monthly",
    payment_method_id: "pm_1OdVq82eZvKYlo2C",
    billing_cycle_anchor: 1717200000,
    items: [
      { price_id: "price_1Msz82eZvKYlo2C", quantity: 1 },
      { price_id: "price_addon_seats_pro", quantity: 5 }
    ],
    trial_period_days: 14,
    coupon_code: "LAUNCH2026",
    metadata: {
      referrer: "onboarding_flow",
      account_manager: "priya.raman"
    }
  },
  { idempotency_key: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" }
)

puts subscription.id`,
}

const responseSnippets: Record<StatusKey, string> = {
  '200': `{
  "id": "sub_1Om48B2eZvKYlo2CqO8k2",
  "object": "subscription",
  "customer": "cus_N63vKZbI8O8yWp",
  "status": "trialing",
  "plan": {
    "id": "plan_pro_monthly",
    "name": "Pro Tier Monthly",
    "amount": 4900,
    "currency": "usd",
    "interval": "month"
  },
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_98f12a3bc4d5",
        "price": "price_1Msz82eZvKYlo2C",
        "quantity": 1
      },
      {
        "id": "si_98f12a3bc4d6",
        "price": "price_addon_seats_pro",
        "quantity": 5
      }
    ],
    "total_count": 2
  },
  "current_period_start": 1717200000,
  "current_period_end": 1719792000,
  "trial_start": 1717200000,
  "trial_end": 1718409600,
  "cancel_at_period_end": false,
  "latest_invoice": "in_1Om48B2eZvKYlo2Cj891",
  "metadata": {
    "account_manager": "priya.raman",
    "referrer": "onboarding_flow"
  },
  "created_at": 1717200000
}`,
  '400': `{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "param": "customer_id",
    "message": "Missing required param: customer_id. Please provide a valid customer identifier.",
    "doc_url": "https://api.acme.com/docs/errors#parameter_missing"
  }
}`,
  '401': `{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API Key provided: uipkge_live_51Msz... Check your secret key in dashboard.",
    "doc_url": "https://api.acme.com/docs/errors#authentication"
  }
}`,
}

function copyEndpoint() {
  if (typeof navigator !== 'undefined' && navigator.clipboard) {
    navigator.clipboard.writeText(endpointUrl)
    copiedEndpoint.value = true
    setTimeout(() => {
      copiedEndpoint.value = false
    }, 2000)
  }
}

function copyRequestSnippet() {
  const code = requestSnippets[selectedLang.value]
  if (typeof navigator !== 'undefined' && navigator.clipboard) {
    navigator.clipboard.writeText(code)
    copiedRequest.value = true
    setTimeout(() => {
      copiedRequest.value = false
    }, 2000)
  }
}

function copyResponseSnippet() {
  const json = responseSnippets[selectedStatus.value]
  if (typeof navigator !== 'undefined' && navigator.clipboard) {
    navigator.clipboard.writeText(json)
    copiedResponse.value = true
    setTimeout(() => {
      copiedResponse.value = false
    }, 2000)
  }
}
</script>

<template>
  <div
    data-slot="api-documentation-page"
    :class="
      cn('bg-background text-foreground border-border w-full overflow-hidden rounded-xl border shadow-xs', props.class)
    "
  >
    <!-- Top Reference Navigation Bar -->
    <header
      class="border-border bg-card/60 flex flex-wrap items-center justify-between gap-4 border-b px-4 py-3 sm:px-6"
    >
      <div class="flex flex-wrap items-center gap-3">
        <div class="bg-primary/10 text-primary flex size-8 items-center justify-center rounded-lg">
          <Server class="size-4" />
        </div>
        <div class="flex items-center gap-2">
          <span class="text-foreground text-xs font-semibold">Acme Billing API</span>
          <span class="text-muted-foreground text-xs">/</span>
          <span class="text-muted-foreground text-xs">Subscriptions</span>
          <Badge variant="secondary" class="font-mono text-xs font-normal">v2026-03-01</Badge>
        </div>
      </div>

      <div class="flex flex-wrap items-center gap-2">
        <div class="border-border bg-background/80 flex items-center gap-2 rounded-md border px-2.5 py-1 text-xs">
          <span class="bg-success size-2 rounded-full" />
          <span class="text-muted-foreground font-mono text-xs">Base:</span>
          <span class="font-mono font-medium">https://api.acme.com/v1</span>
        </div>
        <Button variant="outline" size="sm" class="h-7 gap-1.5 text-xs" @click="copyEndpoint">
          <Check v-if="copiedEndpoint" class="text-success size-3" />
          <Copy v-else class="size-3" />
          {{ copiedEndpoint ? 'Copied URL' : 'Copy Base URL' }}
        </Button>
      </div>
    </header>

    <!-- Two-Column Reference Layout -->
    <div class="grid grid-cols-1 lg:grid-cols-12">
      <!-- Left Main Column: Documentation Prose & Schema Tables (approx 58-60%) -->
      <main class="border-border space-y-8 p-4 sm:p-6 lg:col-span-7 lg:border-r lg:p-8">
        <!-- Endpoint Section Header -->
        <section class="space-y-4">
          <div class="flex flex-wrap items-center gap-2.5">
            <span
              class="border-success/30 bg-success/10 text-success inline-flex items-center rounded-md border px-2.5 py-0.5 font-mono text-xs font-bold tracking-wider"
            >
              POST
            </span>
            <span class="text-foreground font-mono text-sm font-semibold tracking-tight sm:text-base">
              {{ endpointPath }}
            </span>
          </div>

          <div>
            <h1 class="text-foreground text-2xl font-bold tracking-tight sm:text-3xl">Create a subscription</h1>
            <p class="text-muted-foreground mt-2 text-sm leading-relaxed">
              Creates a new recurring subscription contract for an existing customer account. If a default payment
              method is attached, initial recurring invoices are calculated and charged upon trial conclusion or cycle
              anchor date.
            </p>
          </div>

          <!-- Metadata Badges -->
          <div class="flex flex-wrap items-center gap-2 pt-1">
            <div
              class="border-border bg-card text-muted-foreground inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs"
            >
              <Zap class="text-warning size-3.5" />
              <span>Idempotent:</span>
              <span class="text-foreground font-medium">Yes (via Idempotency-Key)</span>
            </div>

            <div
              class="border-border bg-card text-muted-foreground inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs"
            >
              <ShieldCheck class="text-success size-3.5" />
              <span>Auth:</span>
              <span class="text-foreground font-medium">Bearer Secret Key</span>
            </div>

            <div
              class="border-border bg-card text-muted-foreground inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs"
            >
              <Globe class="text-foreground/70 size-3.5" />
              <span>Rate Limit:</span>
              <span class="text-foreground font-medium">100 req/min</span>
            </div>
          </div>
        </section>

        <Separator />

        <!-- Request Headers -->
        <section class="space-y-3">
          <div class="flex items-center justify-between">
            <h2 class="text-foreground text-xs font-semibold tracking-wider uppercase">Request Headers</h2>
            <Badge variant="secondary" class="font-mono text-xs font-normal">HTTP/1.1 & HTTP/2</Badge>
          </div>

          <Card class="border-border overflow-hidden border shadow-none">
            <div class="overflow-x-auto">
              <Table>
                <TableHeader>
                  <TableRow class="bg-muted/40 hover:bg-muted/40">
                    <TableHead class="text-xs font-semibold">Header</TableHead>
                    <TableHead class="text-xs font-semibold">Type</TableHead>
                    <TableHead class="text-xs font-semibold">Requirement</TableHead>
                    <TableHead class="text-xs font-semibold">Description</TableHead>
                  </TableRow>
                </TableHeader>
                <TableBody>
                  <TableRow v-for="header in headersList" :key="header.name" class="text-xs">
                    <TableCell class="text-foreground font-mono font-medium">
                      {{ header.name }}
                    </TableCell>
                    <TableCell>
                      <Badge variant="secondary" class="font-mono text-xs font-normal">
                        {{ header.type }}
                      </Badge>
                    </TableCell>
                    <TableCell>
                      <Badge
                        v-if="header.required"
                        class="border-destructive/20 bg-destructive/10 text-destructive text-xs"
                      >
                        REQUIRED
                      </Badge>
                      <span v-else class="text-muted-foreground text-xs">optional</span>
                    </TableCell>
                    <TableCell class="text-muted-foreground">
                      <p>{{ header.description }}</p>
                      <code class="text-foreground/80 mt-1 inline-block font-mono text-xs"
                        >Sample: {{ header.sample }}</code
                      >
                    </TableCell>
                  </TableRow>
                </TableBody>
              </Table>
            </div>
          </Card>
        </section>

        <!-- Request Body Parameters -->
        <section class="space-y-3">
          <div class="flex items-center justify-between">
            <div class="space-y-0.5">
              <h2 class="text-foreground text-xs font-semibold tracking-wider uppercase">Request Body Parameters</h2>
              <p class="text-muted-foreground text-xs">Provide arguments in a standard JSON payload format.</p>
            </div>
            <Badge variant="outline" class="font-mono text-xs font-normal">application/json</Badge>
          </div>

          <Card class="border-border overflow-hidden border shadow-none">
            <div class="overflow-x-auto">
              <Table>
                <TableHeader>
                  <TableRow class="bg-muted/40 hover:bg-muted/40">
                    <TableHead class="text-xs font-semibold">Parameter</TableHead>
                    <TableHead class="text-xs font-semibold">Type</TableHead>
                    <TableHead class="text-xs font-semibold">Requirement</TableHead>
                    <TableHead class="text-xs font-semibold">Description & Constraints</TableHead>
                  </TableRow>
                </TableHeader>
                <TableBody>
                  <template v-for="param in bodyParams" :key="param.name">
                    <TableRow class="text-xs">
                      <TableCell class="text-foreground font-mono font-medium">
                        {{ param.name }}
                      </TableCell>
                      <TableCell>
                        <Badge variant="secondary" class="font-mono text-xs font-normal">
                          {{ param.type }}
                        </Badge>
                      </TableCell>
                      <TableCell>
                        <Badge
                          v-if="param.required"
                          class="border-destructive/20 bg-destructive/10 text-destructive text-xs"
                        >
                          REQUIRED
                        </Badge>
                        <span v-else class="text-muted-foreground text-xs">optional</span>
                      </TableCell>
                      <TableCell class="text-muted-foreground">
                        <p>{{ param.description }}</p>
                        <div v-if="param.example" class="mt-1">
                          <span class="text-muted-foreground text-xs">Example: </span>
                          <code class="text-foreground font-mono text-xs">{{ param.example }}</code>
                        </div>
                      </TableCell>
                    </TableRow>

                    <!-- Nested Schema Rows -->
                    <template v-if="param.nested">
                      <TableRow v-for="child in param.nested" :key="child.name" class="bg-muted/15 text-xs">
                        <TableCell class="text-foreground pl-6 font-mono text-xs font-medium">
                          <div class="flex items-center gap-1.5">
                            <CornerDownRight class="text-muted-foreground size-3 shrink-0" />
                            <span>{{ child.name }}</span>
                          </div>
                        </TableCell>
                        <TableCell>
                          <Badge variant="outline" class="font-mono text-xs font-normal">
                            {{ child.type }}
                          </Badge>
                        </TableCell>
                        <TableCell>
                          <Badge
                            v-if="child.required"
                            class="border-destructive/20 bg-destructive/10 text-destructive text-xs"
                          >
                            REQUIRED
                          </Badge>
                          <span v-else class="text-muted-foreground text-xs">optional</span>
                        </TableCell>
                        <TableCell class="text-muted-foreground">
                          <p>{{ child.description }}</p>
                          <div v-if="child.example" class="mt-1">
                            <span class="text-muted-foreground text-xs">Example: </span>
                            <code class="text-foreground font-mono text-xs">{{ child.example }}</code>
                          </div>
                        </TableCell>
                      </TableRow>
                    </template>
                  </template>
                </TableBody>
              </Table>
            </div>
          </Card>
        </section>

        <!-- Response Schema Attributes -->
        <section class="space-y-3">
          <div class="space-y-0.5">
            <h2 class="text-foreground text-xs font-semibold tracking-wider uppercase">Response Object Attributes</h2>
            <p class="text-muted-foreground text-xs">
              Properties returned in the 200 OK HTTP JSON payload representation.
            </p>
          </div>

          <Card class="border-border overflow-hidden border shadow-none">
            <div class="overflow-x-auto">
              <Table>
                <TableHeader>
                  <TableRow class="bg-muted/40 hover:bg-muted/40">
                    <TableHead class="text-xs font-semibold">Attribute</TableHead>
                    <TableHead class="text-xs font-semibold">Type</TableHead>
                    <TableHead class="text-xs font-semibold">Description</TableHead>
                    <TableHead class="text-xs font-semibold">Sample Value</TableHead>
                  </TableRow>
                </TableHeader>
                <TableBody>
                  <TableRow v-for="attr in responseAttributes" :key="attr.name" class="text-xs">
                    <TableCell class="text-foreground font-mono font-medium">
                      {{ attr.name }}
                    </TableCell>
                    <TableCell>
                      <Badge variant="secondary" class="font-mono text-xs font-normal">
                        {{ attr.type }}
                      </Badge>
                    </TableCell>
                    <TableCell class="text-muted-foreground">
                      {{ attr.description }}
                    </TableCell>
                    <TableCell class="text-foreground/90 font-mono text-xs">
                      {{ attr.example }}
                    </TableCell>
                  </TableRow>
                </TableBody>
              </Table>
            </div>
          </Card>
        </section>
      </main>

      <!-- Right Column: Interactive Code & Response Inspector (approx 40-42%, Dark Slate) -->
      <aside class="bg-muted/20 space-y-6 p-4 sm:p-6 lg:col-span-5">
        <div class="space-y-6 lg:sticky lg:top-6">
          <!-- Request Code Card -->
          <div class="overflow-hidden rounded-xl border border-neutral-800 bg-neutral-950 text-neutral-100 shadow-md">
            <!-- Language Selector Tabs Header -->
            <div
              class="flex flex-wrap items-center justify-between border-b border-neutral-800 bg-neutral-900/90 px-3 py-2"
            >
              <div class="flex items-center gap-1 overflow-x-auto">
                <button
                  type="button"
                  :class="
                    cn(
                      'rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedLang === 'curl'
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedLang = 'curl'"
                >
                  cURL
                </button>
                <button
                  type="button"
                  :class="
                    cn(
                      'rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedLang === 'node'
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedLang = 'node'"
                >
                  Node.js
                </button>
                <button
                  type="button"
                  :class="
                    cn(
                      'rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedLang === 'python'
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedLang = 'python'"
                >
                  Python
                </button>
                <button
                  type="button"
                  :class="
                    cn(
                      'rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedLang === 'go'
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedLang = 'go'"
                >
                  Go
                </button>
                <button
                  type="button"
                  :class="
                    cn(
                      'rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedLang === 'ruby'
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedLang = 'ruby'"
                >
                  Ruby
                </button>
              </div>

              <Button
                variant="ghost"
                size="sm"
                class="h-7 shrink-0 gap-1.5 text-xs text-neutral-300 hover:bg-neutral-800 hover:text-neutral-100"
                @click="copyRequestSnippet"
              >
                <Check v-if="copiedRequest" class="text-success size-3" />
                <Copy v-else class="size-3" />
                {{ copiedRequest ? 'Copied' : 'Copy' }}
              </Button>
            </div>

            <!-- Subheader Bar -->
            <div class="flex items-center justify-between border-b border-neutral-800/60 bg-neutral-950/60 px-4 py-1.5">
              <div class="flex items-center gap-2">
                <Terminal class="size-3.5 text-neutral-400" />
                <span class="font-mono text-xs text-neutral-400">Request Example</span>
              </div>
              <span class="font-mono text-xs text-neutral-500 uppercase">{{ selectedLang }}</span>
            </div>

            <!-- Code Body -->
            <div class="max-h-[360px] overflow-auto p-4 font-mono text-xs leading-relaxed text-neutral-200">
              <pre class="whitespace-pre"><code>{{ requestSnippets[selectedLang] }}</code></pre>
            </div>
          </div>

          <!-- Response Code Card -->
          <div class="overflow-hidden rounded-xl border border-neutral-800 bg-neutral-950 text-neutral-100 shadow-md">
            <!-- Response Status Tabs Header -->
            <div
              class="flex flex-wrap items-center justify-between border-b border-neutral-800 bg-neutral-900/90 px-3 py-2"
            >
              <div class="flex items-center gap-1.5 overflow-x-auto">
                <span class="mr-1 text-xs font-semibold tracking-wider text-neutral-400 uppercase">Response</span>

                <button
                  v-for="pill in statusPills"
                  :key="pill.code"
                  type="button"
                  :class="
                    cn(
                      'flex items-center gap-1.5 rounded-md px-2.5 py-1 font-mono text-xs transition-colors',
                      selectedStatus === pill.code
                        ? 'bg-neutral-800 font-semibold text-neutral-100 shadow-xs'
                        : 'text-neutral-400 hover:bg-neutral-800/50 hover:text-neutral-200',
                    )
                  "
                  @click="selectedStatus = pill.code"
                >
                  <span :class="cn('size-2 rounded-full', pill.dotColor)" />
                  <span>{{ pill.label }}</span>
                </button>
              </div>

              <Button
                variant="ghost"
                size="sm"
                class="h-7 shrink-0 gap-1.5 text-xs text-neutral-300 hover:bg-neutral-800 hover:text-neutral-100"
                @click="copyResponseSnippet"
              >
                <Check v-if="copiedResponse" class="text-success size-3" />
                <Copy v-else class="size-3" />
                {{ copiedResponse ? 'Copied' : 'Copy' }}
              </Button>
            </div>

            <!-- Subheader Status Description -->
            <div class="border-b border-neutral-800/60 bg-neutral-950/60 px-4 py-2 text-xs text-neutral-400">
              <span>{{ statusPills.find((p) => p.code === selectedStatus)?.summary }}</span>
            </div>

            <!-- JSON Response Payload -->
            <div class="max-h-[380px] overflow-auto p-4 font-mono text-xs leading-relaxed text-neutral-200">
              <pre class="whitespace-pre"><code>{{ responseSnippets[selectedStatus] }}</code></pre>
            </div>
          </div>
        </div>
      </aside>
    </div>
  </div>
</template>