package com.hzya.frame.sys.service;

import com.alibaba.fastjson.JSONObject;

/**
 * @Description 调用api接口
 * @Author xiangerlin
 * @Date 2023/8/8 15:57
 **/
public interface IExcApiService {
    /**
     * 执行api接口
     * 其中 api_id必填
     * 如果需要传参数 以json格式设置到expand_param字段。 只会往body参数上设置，和api配置页面参数名重复时以expand_param为准
     * @param jsonObject
     * @return JSONObject
     *          flag为true时表示接口调用成功，msg为接口响应参数。（这里的成功仅代表接口调通了，并不代表业务是成功的）
     *          flag为false时表示接口调用失败，msg为错误信息。（这里的失败表示接口不通，或系统异常）
     * @throws Exception
     */
     JSONObject execute(JSONObject jsonObject)throws Exception;

    /**
     * 根据api_id执行api接口
     * @param api_id sys_app_api.id
     * @return JSONObject
     *          flag为true时表示接口调用成功，msg为接口响应参数。（这里的成功仅代表接口调通了，并不代表业务是成功的）
     *          flag为false时表示接口调用失败，msg为错误信息。（这里的失败表示接口不通，或系统异常）
     * @throws Exception
     */
     JSONObject execute(String api_id)throws Exception;
}
