route.ts

route.ts

基本信息

  • 类型: API 路由
  • 路径: ./src/app/api/prompts/route.ts
  • 路由: /api/prompts

概述

Prompt 列表和创建接口。支持获取公开 Prompt 列表（支持分页、筛选、搜索）以及创建新的 Prompt。

HTTP 方法

  • GET: 获取 Prompt 列表
  • POST: 创建新 Prompt

GET - 获取 Prompt 列表

Query 参数

参数类型必填说明
pagenumber否页码，默认 1
perPagenumber否每页数量，默认 24
typestring否按类型筛选 (TEXT, IMAGE, VIDEO, AUDIO, SKILL)
categorystring否按分类 ID 筛选
tagstring否按标签 slug 筛选，支持多个（逗号分隔）
sortstring否排序方式: newest, oldest, upvotes
qstring否搜索关键词

响应

成功 (200)

{
  "prompts": [
    {
      "id": "prompt_id",
      "title": "Prompt 标题",
      "slug": "prompt-title",
      "description": "描述",
      "content": "Prompt 内容",
      "type": "TEXT",
      "mediaUrl": null,
      "author": { ... },
      "category": { ... },
      "tags": [ ... ],
      "voteCount": 10,
      "contributorCount": 2,
      "_count": { ... },
      "userExamples": [ ... ]
    }
  ],
  "total": 100,
  "page": 1,
  "perPage": 24,
  "totalPages": 5
}

错误 (500)

{
  "error": "server_error",
  "message": "Something went wrong"
}

POST - 创建新 Prompt

Body 参数

参数类型必填说明
titlestring是标题，1-200 字符
descriptionstring否描述，最多 500 字符
contentstring是Prompt 内容
typeenum是类型: TEXT, IMAGE, VIDEO, AUDIO, SKILL
structuredFormatenum否结构化格式: JSON, YAML
categoryIdstring否分类 ID
tagIdsstring[]是标签 ID 数组
contributorIdsstring[]否贡献者用户 ID 数组
isPrivateboolean是是否私有
mediaUrlstring否媒体 URL
requiresMediaUploadboolean否是否需要媒体上传
requiredMediaTypeenum否所需媒体类型: IMAGE, VIDEO, DOCUMENT
requiredMediaCountnumber否所需媒体数量 (1-10)
bestWithModelsstring[]否最佳使用模型（最多3个）
bestWithMCPobject[]否MCP 配置
workflowLinkstring否工作流链接

响应

成功 (200)

返回创建的完整 Prompt 对象

错误

未授权 (401)
{
  "error": "unauthorized",
  "message": "You must be logged in"
}
验证失败 (400)
{
  "error": "validation_error",
  "message": "Invalid input",
  "details": [...]
}
重复内容 (409)
{
  "error": "duplicate_prompt",
  "message": "You already have a prompt with the same title or content",
  "existingPromptId": "...",
  "existingPromptSlug": "..."
}
相似内容 (409)
{
  "error": "content_exists",
  "message": "A prompt with similar content already exists",
  "existingPromptId": "...",
  "existingPromptSlug": "..."
}
频率限制 (429)
{
  "error": "rate_limit",
  "message": "Please wait 30 seconds before creating another prompt"
}
每日限制 (429) - 仅标记用户
{
  "error": "daily_limit",
  "message": "You have reached the daily limit of 5 prompts"
}

依赖

  • next/server - Next.js 服务器组件
  • next/cache - 缓存重新验证
  • zod - 输入验证
  • @/lib/auth - 认证
  • @/lib/db - Prisma 数据库客户端
  • @/lib/webhook - Webhook 触发
  • @/lib/ai/embeddings - AI 嵌入生成
  • @/lib/slug - Slug 生成
  • @/lib/ai/quality-check - 质量检查
  • @/lib/similarity - 内容相似度检测

权限

  • GET: 公开访问（仅返回公开、未删除、未隐藏的 Prompt）
  • POST: 需要登录
← 返回目录