開発者ドキュメント

# APIキーを環境変数に設定
export DSB_API_KEY="dsb_live_your_api_key_here"

# ヘルスチェックエンドポイントで接続確認
curl -X GET "https://api.devstackbase.com/v1/health" \
  -H "Authorization: Bearer $DSB_API_KEY" \
  -H "Content-Type: application/json"

# 期待されるレスポンス:
# {
#   "status": "ok",
#   "version": "v1",
#   "region": "ap-northeast-1",
#   "timestamp": "2026-05-20T09:00:00Z"
# }

curl -X POST "https://api.devstackbase.com/v1/deployments" \
  -H "Authorization: Bearer $DSB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-app",
    "image": "my-registry/my-app:latest",
    "replicas": 2,
    "resources": {
      "cpu": "500m",
      "memory": "512Mi"
    },
    "env": [
      {"name": "NODE_ENV", "value": "production"},
      {"name": "PORT", "value": "3000"}
    ],
    "ports": [{"containerPort": 3000, "protocol": "TCP"}]
  }'

Authorization: Bearer dsb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "id": "dep_a1b2c3d4e5f6",
  "name": "my-first-app",
  "status": "deploying",
  "image": "my-registry/my-app:latest",
  "replicas": {
    "desired": 2,
    "ready": 0,
    "available": 0
  },
  "endpoint": "https://my-first-app.dsb.app",
  "region": "ap-northeast-1",
  "createdAt": "2026-05-20T09:00:00Z",
  "updatedAt": "2026-05-20T09:00:01Z"
}

# npm
npm install @devstackbase/sdk

# yarn
yarn add @devstackbase/sdk

# pnpm
pnpm add @devstackbase/sdk

import { DevStackBaseClient } from '@devstackbase/sdk';

// クライアントの初期化
const client = new DevStackBaseClient({
  apiKey: process.env.DSB_API_KEY,
  region: 'ap-northeast-1',
  timeout: 30000,
});

// デプロイメントの作成
async function deployApp() {
  try {
    const deployment = await client.deployments.create({
      name: 'my-app',
      image: 'registry.dsb.app/my-app:v1.2.0',
      replicas: 3,
      resources: { cpu: '500m', memory: '512Mi' },
      autoscaling: {
        minReplicas: 2,
        maxReplicas: 10,
        targetCPU: 70,
      },
    });
    console.log(`Deployed: ${deployment.endpoint}`);
  } catch (err) {
    if (err instanceof DevStackBaseClient.RateLimitError) {
      console.log('Rate limited. Retry after:', err.retryAfter);
    }
    throw err;
  }
}

deployApp();

# インストール
# pip install devstackbase

from devstackbase import Client
import os

client = Client(api_key=os.environ["DSB_API_KEY"])

# デプロイメント一覧を取得
deployments = client.deployments.list(status="running")
for dep in deployments.items:
    print(f"{dep.name}: {dep.status} ({dep.replicas.ready}/{dep.replicas.desired})")

# メトリクスの取得
metrics = client.deployments.get_metrics(
    deployment_id="dep_a1b2c3d4e5f6",
    start="2026-05-19T00:00:00Z",
    end="2026-05-20T00:00:00Z",
    resolution="1m"
)
print(f"平均CPU: {metrics.cpu.avg:.1f}%")
print(f"平均メモリ: {metrics.memory.avg_mb:.0f}MB")