洛克王国图鉴

<?php
/**
 * ========================================
 * 洛克王国图鉴 API 接口文档
 * ========================================
 * 
 * 基础URL: http://api.oiapi.net/api/rocom
 * 
 * 响应格式:
 *   { "code": 1, "msg": "success", "data": { ... } }
 *   code=1 成功, code=-1 错误, code=-10 数据不存在
 * 
 * 通用参数:
 *   page    - 页码，默认1
 *   limit   - 每页数量，默认20
 *   element - 元素筛选，支持中英文（光/light, 火/fire, 水/water 等）
 *   season  - 赛季筛选（S1, S2）
 * 
 * 元素对照:
 *   光:light  冰:ice    地:ground  幻:illusion  幽:ghost
 *   恶:dark   普通:normal  机械:steel  武:fighting  毒:poison
 *   水:water  火:fire    电:electric 翼:flying   草:grass
 *   萌:fairy  虫:bug     龙:dragon
 */

// ========================================
// 1. 精灵搜索
// ========================================
// 搜索精灵，同时返回匹配的技能和被动
GET /api/rocom/monsters/迪莫              // 按名称搜索
GET /api/rocom/monsters/monster-xxx       // 按ID精确搜索
GET /api/rocom/monsters/001               // 按编号搜索
GET /api/rocom/monsters?element=光        // 按元素筛选
GET /api/rocom/monsters?element=fire      // 元素支持英文
GET /api/rocom/monsters?egg_group=植物    // 按蛋组筛选
GET /api/rocom/monsters?breedable=1       // 只查可生蛋精灵
GET /api/rocom/monsters?page=1&limit=20   // 分页

// ========================================
// 2. 技能搜索
// ========================================
// 搜索技能，同时返回匹配的精灵和被动
GET /api/rocom/skills/冰锋横扫            // 按名称搜索
GET /api/rocom/skills/skill-xxx           // 按ID搜索
GET /api/rocom/skills?element=冰          // 按元素筛选

// ========================================
// 3. 被动/天赋搜索
// ========================================
// 搜索被动，同时返回匹配的精灵和技能
GET /api/rocom/passives/最好的伙伴         // 按名称搜索
GET /api/rocom/passives/克制              // 按描述搜索

// ========================================
// 4. 进化链搜索
// ========================================
GET /api/rocom/evolution/迪莫             // 按成员名称搜索
GET /api/rocom/evolution/015              // 按进化链ID搜索

// ========================================
// 5. 赛季搜索
// ========================================
GET /api/rocom/seasons/S1                 // 搜索特定赛季
GET /api/rocom/seasons                    // 所有赛季

// ========================================
// 6. 赛季宠物搜索
// ========================================
GET /api/rocom/season_pets/钨丝贝贝        // 按名称搜索
GET /api/rocom/season_pets?season=S2      // 按赛季筛选

// ========================================
// 7. 蛋组
// ========================================
GET /api/rocom/egg_groups                 // 所有蛋组列表
GET /api/rocom/egg_group/植物             // 特定蛋组的精灵
GET /api/rocom/breedable                  // 可生蛋精灵列表
GET /api/rocom/breedable?element=光       // 筛选可生蛋的某系精灵
GET /api/rocom/same_egg_group/迪莫        // 与迪莫同蛋组的精灵

// ========================================
// 8. 全局搜索
// ========================================
// 同时搜索所有类型
GET /api/rocom/search/迪莫

// ========================================
// 9. 元素信息
// ========================================
GET /api/rocom/elements                   // 所有元素/技能类型/角色列表

// ========================================
// 返回数据结构
// ========================================
// 精灵详情:
//   skills: { level:[{name,power,pp,element_cn,category_cn,learn_level,image_url}], bloodline:[], skill_stone:[] }
//   passives_detail: [{name,description,image_url}]
//   evolution_chain: {members:[{name,stage,level,image_url}]}
//   egg_groups: ["陆上"], egg_groups_cn: ["陆上组"], can_breed: true
//   stats: {hp,atk,spa,defense,spd,spe}
//   elements: ["light"], elements_cn: ["光"]
//   full_image_url: "https://..."
//
// 技能详情:
//   element_cn, category_cn, power, pp, accuracy, description
//   learnable_by: [{name,no,elements_cn}]  // 可学该技能的精灵
//   image_url, full_image_url
//
// 被动详情:
//   name, description, trigger
//   used_by: [{name,no}]  // 拥有该被动的精灵
//   image_url, full_image_url