Api Endpoint

API Route Template

// app/api/example/route.ts
import { NextRequest, NextResponse } from 'next/server';

interface ExampleResponse {
  data: ExampleData | null;
  error: { code: string; message: string } | null;
}

export async function GET(request: NextRequest): Promise<NextResponse<ExampleResponse>> {
  try {
    const searchParams = request.nextUrl.searchParams;
    const id = searchParams.get('id');

    if (!id) {
      return NextResponse.json(
        { data: null, error: { code: 'MISSING_ID', message: 'ID is required' } },
        { status: 400 }
      );
    }

    const data = await fetchData(id);

    return NextResponse.json({ data, error: null });
  } catch (error) {
    console.error('API error:', error);
    return NextResponse.json(
      { data: null, error: { code: 'INTERNAL_ERROR', message: 'Failed to fetch data' } },
      { status: 500 }
    );
  }
}

Dynamic Route Template

// app/api/wallets/[address]/route.ts
import { NextRequest, NextResponse } from 'next/server';

interface RouteContext {
  params: Promise<{ address: string }>;
}

export async function GET(
  request: NextRequest,
  context: RouteContext
): Promise<NextResponse> {
  const { address } = await context.params;

  // Validate address
  if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
    return NextResponse.json(
      { data: null, error: { code: 'INVALID_ADDRESS', message: 'Invalid address' } },
      { status: 400 }
    );
  }

  // Fetch and return data...
}