import Layout from "@/components/Layout"; import SEO from "@/components/SEO"; import { Breadcrumbs } from "@/components/dev-platform/Breadcrumbs"; import { ThreeColumnLayout } from "@/components/dev-platform/layouts/ThreeColumnLayout"; import { CodeTabs } from "@/components/dev-platform/CodeTabs"; import { Callout } from "@/components/dev-platform/ui/Callout"; import { Card } from "@/components/ui/card"; import { Button } from "@/components/ui/button"; import { Badge } from "@/components/ui/badge"; import { Zap, Key, Code, Rocket, CheckCircle2, ExternalLink } from "lucide-react"; import { Link } from "react-router-dom"; const steps = [ { id: "signup", title: "Create Account", icon: CheckCircle2 }, { id: "api-key", title: "Get API Key", icon: Key }, { id: "first-request", title: "First Request", icon: Code }, { id: "explore", title: "Explore API", icon: Rocket }, ]; export default function QuickStart() { const sidebarContent = (
{steps.map((step) => ( {step.title} ))}
); const asideContent = (

Get Started in 5 Minutes

Follow this guide to make your first API request and start building with AeThex.

Quick Links

Need Help?

Join our Discord community for support and examples.

); return (
{/* Introduction */}

Build Something Amazing

This guide will help you make your first API request in under 5 minutes. You'll learn how to authenticate, fetch data, and start building.

{steps.map((step, index) => (
{index + 1}

{step.title}

))}
{/* Step 1: Create Account */}

Step 1: Create Your Account

First, you'll need an AeThex account to access the developer dashboard.

  1. 1

    Sign up for free

    Visit aethex.dev/login and create your account

  2. 2

    Verify your email

    Check your inbox and click the verification link

  3. 3

    Complete onboarding

    Set up your profile and choose your primary realm

Free for developers

All AeThex accounts include free API access with generous rate limits. No credit card required.

{/* Step 2: Get API Key */}

Step 2: Generate Your API Key

Navigate to the developer dashboard to create your first API key.

  1. 1

    Go to Developer Dashboard

    Visit Dashboard → API Keys

  2. 2

    Create new key

    Click "Create Key" and give it a name (e.g., "Development Key")

  3. 3

    Choose permissions

    Select scopes: read for getting started

  4. 4

    Save your key

    Copy the key immediately - it won't be shown again!

⚠️ Keep your API key secret

Never commit API keys to git or share them publicly. Store them in environment variables or a secure secrets manager.

{/* Step 3: First Request */}

Step 3: Make Your First Request

Let's fetch your user profile to verify everything works.

console.log('Success!', profile)) .catch(error => console.error('Error:', error));`, }, { language: "python", label: "Python", code: `import requests import json # Replace with your actual API key API_KEY = 'aethex_sk_your_key_here' def get_my_profile(): response = requests.get( 'https://aethex.dev/api/user/profile', headers={ 'Authorization': f'Bearer {API_KEY}', 'Content-Type': 'application/json' } ) if not response.ok: raise Exception(f'HTTP {response.status_code}: {response.text}') profile = response.json() print(f"Username: {profile['username']}") print(f"Level: {profile['level']}") print(f"Total XP: {profile['total_xp']}") return profile # Run it try: profile = get_my_profile() print('Success!', json.dumps(profile, indent=2)) except Exception as e: print('Error:', e)`, }, { language: "bash", label: "cURL", code: `# Replace with your actual API key export API_KEY="aethex_sk_your_key_here" curl https://aethex.dev/api/user/profile \\ -H "Authorization: Bearer $API_KEY" \\ -H "Content-Type: application/json" # Expected response: # { # "id": "uuid", # "username": "yourusername", # "level": 5, # "total_xp": 4250, # "bio": "...", # ... # }`, }, ]} />

🎉 Success!

If you see your profile data, you're all set! Your API key is working correctly.

Common Issues

401 Unauthorized

Check that your API key is correct and includes the Bearer prefix

429 Too Many Requests

You've hit the rate limit. Wait a minute and try again.

{/* Step 4: Explore */}

Step 4: Explore the API

Now that you're authenticated, try out these common operations.

Get Community Posts

Fetch the latest posts from the community feed

r.json()); console.log(\`Found \${posts.length} posts\`);`, }, ]} />

Create a Post

Share content with the community

r.json());`, }, ]} />

Search Creators

Find creators by arm or skill

r.json()); creators.data.forEach(c => { console.log(c.username, c.primary_arm); });`, }, ]} />

Browse Opportunities

Discover job opportunities on the platform

r.json()); jobs.data.forEach(job => { console.log(job.title, job.job_type); });`, }, ]} />
{/* Next Steps */}

Next Steps

You're ready to build! Here are some resources to help you continue:

Full API Reference

Complete documentation of all endpoints, parameters, and responses

Developer Dashboard

Manage your API keys, monitor usage, and track analytics

Join Community

Get help, share projects, and connect with other developers

); }