package com.emotion.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.emotion.dto.request.ApiEndpointListRequest;
import com.emotion.dto.response.ApiEndpointDetailResponse;
import com.emotion.dto.response.ApiEndpointItemResponse;

/**
 * 接口端点服务
 *
 * @author Peanut
 * @date 2026-05-23
 */
public interface ApiEndpointService {

    /**
     * 分页查询接口列表
     */
    IPage<ApiEndpointItemResponse> getPage(ApiEndpointListRequest request);

    /**
     * 查询接口详情（含参数）
     */
    ApiEndpointDetailResponse getDetail(String operationId);

    /**
     * 从 OpenAPI spec 同步接口数据
     */
    void syncFromOpenApi();
}