getting-started

Getting Started with Basta

Step 1: Create Your User Account

Head over to dashboard.basta.app and sign up.

Once you've signed up, your personal user account will be created.

Step 2: Set Up Your Business Account

To access the API, your user must be linked to a business account.

📧 Email us at hi@basta.app after you log in, and we'll:

• Create a business account for your company
• Link it to your user
• Enable access to production APIs

Step 3: Get API Access

Once your business account is live, you'll be able to:

• Generate API keys
• Start exploring our GraphQL endpoints

---

API Access

📝 Step 1: Sign Up & Log In

1. Create your user account at dashboard.basta.app
2. You'll receive your Account ID once your business account is activated
3. Log into the dashboard to create an API key

📬 If you haven't received your Account ID yet, contact us at hi@basta.app

🔑 Step 2: Generate an API Key

Once logged in, navigate to your dashboard's Settings section to generate an API key.

You'll use this key to authenticate your GraphQL requests.

🧾 Step 3: Set Request Headers

All requests to the Management API must include these headers:

{
  "x-account-id": "YOUR_ACCOUNT_ID",
  "x-api-key": "YOUR_API_KEY"
}

✅ These headers are required for both authenticated queries and mutations.

Example Request

curl -X POST https://management-api.basta.app/graphql \
  -H "Content-Type: application/json" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query": "{ __typename }"}'

// JavaScript/TypeScript example
const response = await fetch('https://management-api.basta.app/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-account-id': 'YOUR_ACCOUNT_ID',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    query: `
      query {
        # Your GraphQL query here
      }
    `
  })
});

# Ruby example
require 'net/http'
require 'json'

uri = URI('https://management-api.basta.app/graphql')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['x-account-id'] = 'YOUR_ACCOUNT_ID'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = JSON.generate({
  query: '{ __typename }'
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

What's Next?

• 🔧 Management API - Administrative API for managing auctions
• 🌐 Client API - Public-facing API for auction interactions
• 🪝 Webhooks - Real-time event notifications

Support

For questions or assistance with API access:

• Email: hi@basta.app
• Documentation: docs.basta.ai