This is a sample documentation page. It demonstrates how to combine prose, steps, code blocks, and callouts into a realistic guide.
Prerequisites
Before you begin, make sure you have:
- A running instance of the application (
npm run dev)
- An API key from the dashboard
Keep your API key secret. Never commit it to version control or expose it in client-side code.
Install the SDK
Add the authentication SDK to your project:npm install @example/auth
Initialize the client
Create an auth client with your API key:import { createAuthClient } from "@example/auth";
const auth = createAuthClient({
apiKey: process.env.AUTH_API_KEY,
});
Protect a route
Use the middleware to require authentication:import { auth } from "./auth";
export async function onRequest(context, next) {
const session = await auth.getSession(context.request);
if (!session) {
return new Response("Unauthorized", { status: 401 });
}
return next();
}
Verify it works
After completing the setup, test that authentication is working:
curl -H "Authorization: Bearer YOUR_API_KEY" http://localhost:4321/api/protected
{
"user": {
"id": "usr_123",
"email": "ada@example.com"
}
}
Common issues
401 Unauthorized on every request
Check that your AUTH_API_KEY environment variable is set and matches the key in your dashboard.
Session expires immediately
Next steps