云服务 API

export BASE_URL='https://meoo.com/open/v1'
export PROJECT_ID='your-project-url-id'
export ACCESS_TOKEN='replace-with-authorized-bearer-token'

POST /projects/{project_id}/cloud

curl --fail-with-body --silent --show-error --request POST \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"description":"活动报名项目云服务"}'

{
  "status": "ready",
  "created": true,
  "public_url": "https://your-instance.example",
  "warnings": []
}

{
  "status": "ready",
  "created": false
}

GET /projects/{project_id}/cloud/credentials

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/credentials" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{
  "url": "https://your-instance.example",
  "anon_key": "<anon-key>",
  "service_key": "<service-role-key>"
}

GET /projects/{project_id}/cloud/database/status

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/database/status" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{"status":"ready"}

GET /projects/{project_id}/cloud/database/tables

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/database/tables" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{
  "tables": [
    {
      "schema": "public",
      "name": "registrations",
      "rls_enabled": true,
      "rls_forced": false,
      "estimated_rows": "1280",
      "comment": "活动报名记录",
      "columns": [
        {
          "name": "id",
          "data_type": "uuid",
          "format": "uuid",
          "nullable": false,
          "updatable": true,
          "unique": true,
          "default_value": "gen_random_uuid()",
          "enums": [],
          "comment": "报名记录 ID"
        }
      ]
    }
  ]
}

POST /projects/{project_id}/cloud/database/queries

curl --fail-with-body --silent --show-error --request POST \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/database/queries" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"query":"select 1 as ok"}'

{
  "rows": [{"ok":1}],
  "columns": ["ok"],
  "row_count": 1,
  "truncated": false
}

GET /projects/{project_id}/cloud/storage/buckets

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/storage/buckets" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{
  "buckets": [
    {
      "name": "uploads",
      "public": false,
      "file_size_limit": "10485760",
      "allowed_mime_types": ["image/png", "image/jpeg"],
      "created_at": 1786410000000,
      "updated_at": 1786410000000
    }
  ]
}

GET /projects/{project_id}/cloud/storage/buckets/{bucket_name}/objects

curl --fail-with-body --silent --show-error --get \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/storage/buckets/uploads/objects" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode 'prefix=images/' \
  --data-urlencode 'page_size=20'

{
  "bucket_name": "uploads",
  "prefix": "images/",
  "objects": [
    {
      "name": "banner.png",
      "type": "object",
      "size": "245760",
      "mime_type": "image/png",
      "cache_control": "max-age=3600",
      "etag": "d41d8cd98f00b204e9800998ecf8427e",
      "created_at": 1786410000000,
      "updated_at": 1786410000000,
      "last_accessed_at": 1786413600000
    }
  ]
}

PUT /projects/{project_id}/cloud/storage/buckets/{bucket_name}/objects

curl --fail-with-body --silent --show-error --request PUT \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/storage/buckets/uploads/objects" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "path":"docs/hello.txt",
    "content_base64":"aGVsbG8=",
    "content_type":"text/plain",
    "cache_control":"max-age=3600",
    "upsert":false
  }'

{
  "bucket_name": "uploads",
  "path": "docs/hello.txt",
  "size": "5",
  "content_type": "text/plain",
  "uploaded": true
}

DELETE /projects/{project_id}/cloud/storage/buckets/{bucket_name}/objects

curl --fail-with-body --silent --show-error --request DELETE \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/storage/buckets/uploads/objects" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"paths":["docs/hello.txt"]}'

{
  "bucket_name": "uploads",
  "deleted": ["docs/hello.txt"]
}

GET /projects/{project_id}/cloud/functions

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/functions" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{
  "functions": [
    {
      "name": "hello-world",
      "status": "ACTIVE",
      "version": 1,
      "verify_jwt": true,
      "created_at": 1786410000000,
      "updated_at": 1786410000000
    }
  ]
}

PUT /projects/{project_id}/cloud/functions/{function_name}

(cd hello-world && zip -r ../hello-world.zip .)

python3 - <<'PY' > function-request.json
import base64
import json
from pathlib import Path

archive = Path('hello-world.zip').read_bytes()
print(json.dumps({
    'archive_base64': base64.b64encode(archive).decode('ascii'),
    'verify_jwt': True,
}))
PY

curl --fail-with-body --silent --show-error --request PUT \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/functions/hello-world" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data-binary @function-request.json

{
  "function": {
    "name": "hello-world",
    "status": "ACTIVE",
    "version": 1,
    "verify_jwt": true,
    "created_at": 1786410000000,
    "updated_at": 1786410000000
  }
}

DELETE /projects/{project_id}/cloud/functions/{function_name}

curl --fail-with-body --silent --show-error --request DELETE \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/functions/hello-world" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{"name":"hello-world","deleted":true}

GET /projects/{project_id}/cloud/functions/{function_name}/logs

curl --fail-with-body --silent --show-error --get \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/functions/hello-world/logs" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode 'limit=100'

{
  "function_name": "hello-world",
  "start_time": 1786410000000,
  "end_time": 1786410900000,
  "total": 1,
  "returned": 1,
  "entries": [
    {
      "timestamp": 1786410123000,
      "level": "info",
      "message": "[hello-world] request completed"
    }
  ]
}

PUT /projects/{project_id}/cloud/auth/providers

curl --fail-with-body --silent --show-error --request PUT \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/auth/providers" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"providers":["password","email"]}'

{
  "providers": [
    {"provider":"password","enabled":true},
    {"provider":"email","enabled":true}
  ]
}

GET /projects/{project_id}/cloud/secrets

curl --fail-with-body --silent --show-error \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/secrets" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{
  "secrets": [
    {"name":"EMAIL_API_KEY","updated_at":1786410000000}
  ]
}

PUT /projects/{project_id}/cloud/secrets/{secret_name}

curl --fail-with-body --silent --show-error --request PUT \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/secrets/EMAIL_API_KEY" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"value":"replace-with-secret-value"}'

{"name":"EMAIL_API_KEY","updated":true}

DELETE /projects/{project_id}/cloud/secrets/{secret_name}

curl --fail-with-body --silent --show-error --request DELETE \
  --url "$BASE_URL/projects/$PROJECT_ID/cloud/secrets/EMAIL_API_KEY" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

{"name":"EMAIL_API_KEY","deleted":true}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "当前项目尚未启用云服务",
  "code": "cloud_not_enabled",
  "trace_id": "<trace-id>"
}