Supabase — Supabase工具

Auth (GoTrue)

获取 Auth Health

GET /supabase/auth/v1/health

响应:

{
  "version": "v2.188.1",
  "name": "GoTrue",
  "description": "GoTrue is a user registration and authentication API"
}

获取 Auth Settings

GET /supabase/auth/v1/settings

响应:

{
  "external": {
    "email": true,
    "phone": false,
    "google": false,
    "github": false
  },
  "disable_signup": false,
  "mailer_autoconfirm": false
}

列表 Users (管理员)

GET /supabase/auth/v1/admin/users

响应:

{
  "users": [
    {
      "id": "8974a9fa-95c4-4839-8d50-76f4666d2113",
      "email": "user@example.com",
      "email_confirmed_at": "2026-03-29T23:01:46.718322Z",
      "created_at": "2026-03-29T23:01:46.689584Z"
    }
  ],
  "aud": "authenticated"
}

获取 用户 (管理员)

GET /supabase/auth/v1/admin/users/{user_id}

创建 用户 (管理员)

POST /supabase/auth/v1/admin/users
Content-Type: application/json
{
  "email": "newuser@example.com",
  "password": "securepassword123",
  "email_confirm": true
}

响应:

{
  "id": "8974a9fa-95c4-4839-8d50-76f4666d2113",
  "email": "newuser@example.com",
  "email_confirmed_at": "2026-03-29T23:01:46.718322Z",
  "role": "authenticated",
  "app_metadata": {
    "provider": "email",
    "providers": ["email"]
  }
}

更新 用户 (管理员)

PUT /supabase/auth/v1/admin/users/{user_id}
Content-Type: application/json
{
  "email": "updated@example.com",
  "user_metadata": {
    "name": "Updated Name"
  }
}

删除 用户 (管理员)

DELETE /supabase/auth/v1/admin/users/{user_id}

Storage

列表 Buckets

GET /supabase/storage/v1/bucket

响应:

[
  {
    "id": "avatars",
    "name": "avatars",
    "public": true,
    "created_at": "2026-03-29T23:01:06.638Z",
    "updated_at": "2026-03-29T23:01:06.638Z"
  }
]

获取 Bucket

GET /supabase/storage/v1/bucket/{bucket_id}

创建 Bucket

POST /supabase/storage/v1/bucket
Content-Type: application/json
{
  "id": "documents",
  "name": "documents",
  "public": false,
  "file_size_limit": 10485760,
  "allowed_mime_types": ["application/pdf", "image/png"]
}

更新 Bucket

PUT /supabase/storage/v1/bucket/{bucket_id}
Content-Type: application/json
{
  "public": true
}

删除 Bucket

DELETE /supabase/storage/v1/bucket/{bucket_id}

列表 Objects 在...中 Bucket

POST /supabase/storage/v1/object/list/{bucket_id}
Content-Type: application/json
{
  "prefix": "",
  "limit": 100,
  "offset": 0
}

上传 对象

POST /supabase/storage/v1/object/{bucket_id}/{path}
Content-Type: {mime_type}
{binary_data}

下载 对象

GET /supabase/storage/v1/object/{bucket_id}/{path}

删除 对象

DELETE /supabase/storage/v1/object/{bucket_id}/{path}

分页

PostgREST 分页

Use limit and offset query parameters:

GET /supabase/rest/v1/users?limit=10&offset=20

Use the Range header for range-based pagination:

GET /supabase/rest/v1/users
Range: 0-9

Auth 用户 分页

GET /supabase/auth/v1/admin/users?page=1&per_page=50

Code Examples

JavaScript

// List storage buckets
const response = await fetch(
  'https://gateway.maton.ai/supabase/storage/v1/bucket',
  {
    headers: {
      'Authorization': Bearer ${process.env.MATON_API_KEY}
    }
  }
);
const buckets = await response.json();

Python

import os
import requests
# Query database table
response = requests.get(
    'https://gateway.maton.ai/supabase/rest/v1/users',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    params={'select': 'id,email', 'limit': 10}
)
users = response.json()

创建 用户 和 Storage Bucket

import os
import requests
headers = {
    'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}',
    'Content-Type': 'application/json'
}
# Create auth user
user_resp = requests.post(
    'https://gateway.maton.ai/supabase/auth/v1/admin/users',
    headers=headers,
    json={
        'email': 'test@example.com',
        'password': 'securepass123',
        'email_confirm': True
    }
)
user = user_resp.json()
# Create storage bucket
bucket_resp = requests.post(
    'https://gateway.maton.ai/supabase/storage/v1/bucket',
    headers=headers,
    json={
        'id': 'user-uploads',
        'name': 'user-uploads',
        'public': False
    }
)
bucket = bucket_resp.json()

Notes

• 连接 routes 到 specific Supabase project configured 期间 setup
• PostgREST endpoints auto-generated 从 数据库 schema
• 使用 Prefer: return=representation 页头 到 获取 created/updated records back
• Storage bucket names 必须 unique 在...内 project
• Auth 管理员 endpoints require 服务 角色 permissions
• 数据库 queries support complex filtering, ordering, 和 joins 通过 PostgREST syntax
• IMPORTANT: 当...时 使用 curl commands, 使用 curl -g 当...时 URLs contain brackets 或 special characters
• IMPORTANT: 当...时 piping curl 输出 到 jq, environment variables 可能 不 expand correctly 在...中 一些 shells

错误 Handling

PostgREST Errors

{
  "code": "PGRST205",
  "details": null,
  "hint": null,
  "message": "Could not find the table 'public.users' in the schema cache"
}

Resources

• Supabase REST API Guide
• PostgREST Documentation
• Supabase Auth API
• Supabase Storage API
• Maton Community
• Maton Support