Authentication

# All API requests require authentication
curl -X POST https://api.spooled.cloud/api/v1/jobs \
  -H "Authorization: Bearer sp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queue_name": "my-queue", "payload": {...}}'

import { SpooledClient } from '@spooled/sdk';

// Initialize with API key from environment
const client = new SpooledClient({
  apiKey: process.env.SPOOLED_API_KEY!,
});

// All subsequent calls are authenticated
const job = await client.jobs.create({...});

from spooled import SpooledClient
import os

# Initialize with API key from environment
client = SpooledClient(api_key=os.environ["SPOOLED_API_KEY"])

# All subsequent calls are authenticated
job = client.jobs.create({...})

# Don't forget to close the client
client.close()

import (
	"os"
	"github.com/spooled-cloud/spooled-sdk-go/spooled"
)

// Initialize with API key from environment
client, err := spooled.NewClient(
	spooled.WithAPIKey(os.Getenv("SPOOLED_API_KEY")),
)
if err != nil {
	panic(err)
}
defer client.Close()

// All subsequent calls are authenticated
job, _ := client.Jobs().Create(ctx, &resources.CreateJobRequest{
	QueueName: "emails",
	Payload:   map[string]any{"to": "user@example.com"},
})

<?php

use Spooled\SpooledClient;
use Spooled\Config\ClientOptions;

// Initialize with API key from environment
$client = new SpooledClient(new ClientOptions(
    apiKey: getenv('SPOOLED_API_KEY'),
));

// All subsequent calls are authenticated
$job = $client->jobs->create([...]);

# .env file (add to .gitignore!)
SPOOLED_API_KEY=sp_live_your_api_key

# Use in shell
export SPOOLED_API_KEY=sp_live_your_api_key
curl -H "Authorization: Bearer $SPOOLED_API_KEY" ...

// .env file
SPOOLED_API_KEY=sp_live_your_api_key

// Load with dotenv
import 'dotenv/config';
import { SpooledClient } from '@spooled/sdk';

const client = new SpooledClient({
  apiKey: process.env.SPOOLED_API_KEY!,
});

# .env file
SPOOLED_API_KEY=sp_live_your_api_key

# Load with python-dotenv
from dotenv import load_dotenv
from spooled import SpooledClient
import os

load_dotenv()
client = SpooledClient(api_key=os.environ["SPOOLED_API_KEY"])

// .env file (add to .gitignore!)
// SPOOLED_API_KEY=sp_live_your_api_key

import (
	"os"
	"github.com/joho/godotenv"
	"github.com/spooled-cloud/spooled-sdk-go/spooled"
)

godotenv.Load() // Load .env file
client, _ := spooled.NewClient(
	spooled.WithAPIKey(os.Getenv("SPOOLED_API_KEY")),
)

<?php

// .env file (add to .gitignore!)
// SPOOLED_API_KEY=sp_live_your_api_key

// Load with vlucas/phpdotenv
require_once 'vendor/autoload.php';
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

use Spooled\SpooledClient;
use Spooled\Config\ClientOptions;

$client = new SpooledClient(new ClientOptions(
    apiKey: $_ENV['SPOOLED_API_KEY'],
));

# Create a new API key
curl -X POST https://api.spooled.cloud/api/v1/api-keys \
  -H "Authorization: Bearer sp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Email worker",
    "queues": ["emails"]
  }'

# Response (key shown only once!)
# Omit "queues" (or send []) for a key that can reach every queue.
{
  "id": "key_xxxxx",
  "key": "sp_live_a1b2c3d4...",
  "name": "Email worker",
  "queues": ["emails"],
  "created_at": "2025-01-15T10:30:00Z",
  "expires_at": null
}