SuperAPI AI 工具集

wp-rest-api

编程与开发

查看项目

更新于 10-16 07:22

技能介绍

用途:在 WordPress 中创建或修改 REST 路由与端点、排查 401/403/404 与权限或 nonce 问题、为响应添加自定义字段或 meta、通过 REST 暴露自定义文章类型与分类法、实现 schema 与参数校验、调整响应链接、嵌入与分页。\n\n主要能力与用法:在 rest_api_init 上用 register_rest_route() 注册路由,非平凡逻辑优先用 WP_REST_Controller 子类控制器;使用唯一命名空间 vendor/v1,提供 permission_callback,采用 WP_REST_Server 方法常量,用 rest_ensure_response() 返回数据、WP_Error 返回错误;参数定义 type、default、required、validate_callback、sanitize_callback,推荐 JSON Schema 校验与清理,端点内读取 WP_REST_Request 而非 $_GET/$_POST。字段方面不建议删核心字段,改用 register_rest_field 添加计算字段、register_meta 配合 show_in_rest 暴露 meta;需要原始内容时用 ?context=edit 访问 content.raw 并配合 _fields 精简响应。鉴权上,后台 JS 用 cookie 加 X-WP-Nonce(action 为 wp_rest),外部客户端用应用密码或鉴权插件,permission_callback 中做能力检查。客户端行为需保证发现机制、支持 _fields、_embed、_method、_envelope 与分页头,注意 per_page 上限为 100。\n\n适用场景:插件或主题需要对外提供或扩展 REST 接口、调试 REST 报错、暴露 CPT/分类法。限制:官方未提供具体价格、平台与效果信息;使用该技能需提供仓库根目录与目标入口路径、命名空间与路由、鉴权模式以及目标 WordPress 版本约束(低于 7.0 需说明)。