# Paper Plugin API Contract

## Authentication
- Header: `x-paper-server-key`
- Header: `x-paper-server-secret`
- These values must match a record in `MinecraftServerConfig`.

## Endpoints

### `POST /api/minecraft/sync/check-user`
Request:
```json
{
  "username": "Steve"
}
```

Response:
```json
{
  "success": true,
  "data": {
    "approved": true,
    "accessGranted": true,
    "status": "approved",
    "planCount": 1
  }
}
```

### `POST /api/minecraft/sync/profile`
Returns Minecraft profile, uuid, account state, and active paid/completed plans.

### `POST /api/minecraft/sync/status`
Returns access status and account approval summary suitable for quick gate checks.