# DropWeb

> Static site hosting via API. Upload a zip, get a live URL. One curl, no signup.

## Quick Start

```
POST https://api.dropweb.app/deploy
Content-Type: multipart/form-data
Form field: site = <zip or tar.gz file>
```

Response includes: siteId, url, screenshot, key (save it — shown once), account info, and a hint.

## Key Concepts

- **No signup**: First deploy creates an anonymous account and returns an API key.
- **Key is shown once**: Store it immediately. Required for all management operations.
- **Two tiers**: Anonymous (3 sites, 7-day expiry) → Free (5 sites, 30 days). Upgrade by confirming an email.
- **Archive format**: ZIP or TAR.GZ. Must contain index.html at root. Only static web files allowed.

## Endpoints

- `POST /deploy` — Deploy a new site (anonymous or authenticated)
- `POST /deploy/:siteId` — Redeploy/update an existing site (auth required)
- `GET /sites` — List your sites (auth required)
- `GET /sites/:siteId` — Get site details (auth required)
- `DELETE /sites/:siteId` — Delete a site (auth required)
- `GET /account` — Account status (auth required)
- `POST /account/email` — Start email confirmation (auth required)
- `POST /account/recover` — Recover API key via email

## Authentication

Pass API key via `Authorization: Bearer sk_yourkey` header or `key` form field.

## Email Upgrade Flow

1. Deploy (anonymous) → save key
2. Ask user for their email (never fabricate or guess)
3. `POST /account/email` with key and email
4. User clicks confirmation link in email
5. Account upgrades: 5 sites, 30-day expiry, key recovery

## Full Documentation

- API Reference: https://dropweb.app/help
- OpenAPI spec: https://dropweb.app/openapi.json
- Full LLM docs: https://dropweb.app/llms-full.txt