概述

W-Spaces Deployment

Deploy static websites to W-Spaces (wspaces.app). Create projects, push HTML, and deploy to a live URL — all via API.

Configuration

Get your API key

Register: scripts/wspaces_auth.sh --register --email you@example.com --password yourpass --name "Your Name"
Verify your email (check inbox)
Login: scripts/wspaces_auth.sh --login --email you@example.com --password yourpass
Copy the API key from the response

Set the API key

export WSPACES_API_KEY="wsk_live_xxxx..."

Or store in .env:

WSPACES_API_KEY=wsk_live_xxxx...

Operations

Create a project

scripts/wspaces_project.sh --create --name "My Landing Page"

Response includes project ID and slug.

Push HTML code

# From a file
scripts/wspaces_push.sh --project <project-id> --file ./index.html

# From inline HTML
scripts/wspaces_push.sh --project <project-id> --html "<html><body><h1>Hello</h1></body></html>"

Deploy to live URL

scripts/wspaces_deploy.sh --project <project-id>

Result: https://.wspaces.app

List projects

scripts/wspaces_project.sh --list

Check project details

scripts/wspaces_project.sh --get --id <project-id>

View deployments

scripts/wspaces_deploy.sh --list --project <project-id>

Common Workflows

Deploy a landing page

# 1. Create project
scripts/wspaces_project.sh --create --name "Startup Landing"
# → project ID: abc-123

# 2. Push code
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# 3. Deploy
scripts/wspaces_deploy.sh --project abc-123
# → https://startup-landing-xyz.wspaces.app

Update existing site

# Push new code (creates new version)
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# Redeploy
scripts/wspaces_deploy.sh --project abc-123

Full flow from scratch

Tell your agent:

"Create a W-Spaces project called My Portfolio"
"Push this HTML to my W-Spaces project"
"Deploy my project to wspaces.app"

API Key Management

# Create additional API key
scripts/wspaces_auth.sh --create-key --name "CI/CD Key"

# List all keys
scripts/wspaces_auth.sh --list-keys

# Revoke a key
scripts/wspaces_auth.sh --revoke-key --id <key-id>

API Reference

See wspaces-api.md for complete API documentation.

Troubleshooting

"WSPACES_API_KEY not set"

export WSPACES_API_KEY="wsk_live_xxx..."

"Invalid API key"

Key may be revoked — generate a new one via login
Check for extra spaces when copying

"Please verify your email"

Check your inbox for verification email
Verify before logging in

"Project not found"

Verify project ID with scripts/wspaces_project.sh --list

版本历史

共 1 个版本

v1.0.0 当前

2026-05-02 00:57 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)