把内部接口快速变成开放接口的妙招

如果原来已经有一批内部的API接口，现在需要调整成对外开放的API接口，有没快速的办法，能即刻实现？最好是当天就能部署上线，对外开放使用的解决方案？

如果需要把内部接口变成开放接口，至少需要解决以下问题：

为外部开发者提供注册的页面
开放指定的API接口权限给外部开发者
提供在线接口文档
和内部API接口进行对接
使用新的对外域名，例如：open.xxx.com

选择合适的工具和解决方案，能快速实现你想要的效果，并且最快当天就能上线。

零代码/低代码的API解决方案

我们先来看一个例子。

假设原来使用Java实现的某个内部接口是：Hello Wolrd示例接口，路径是：/api/Hello/World。现在需要转成外部API接口。下面介绍零代码或低代码的解决方案。

首先，进入接口大师的管理后台-接口管理-可视化接口设计-添加接口。然后在接口设计类型选择【接口对接API】，随后在表单中依次填写接口服务名称、接口模块、接口标题、接口参数、接口返回示例等，这些都是新API接口对外展示的内容。

关键的一步，是点击页面上的【生成代码】，系统会自动根据你填写的表单，生成和内部接口对接的PHP代码。

我们把生成的代码复制出来，类似：

<?php
namespace App\Api;
use App\Common\Api;
// use App\Domain\JavaHello as JavaHelloDomain;

/**
 * 内部Java示例接口
 */
class JavaHello extends Api {

    /**
     * 接口参数规则配置
     */
    public function getRules() {
        $rules = parent::getRules();
        $curRules = array(
            'World' => array(
                
                'city' => array (
                'name' => 'city',
                'type' => 'string',
                'require' => true,
              ),

            ),
        );
        return array_merge($rules, $curRules);
    }

    /**
     * 内部Java接口对接示例
     * @desc 内部Java接口对接示例

     * 
     */ 
    public function World() {
        // 接口参数获取
        $city = $this->city; // 参数
        
        // 结果返回
        $rs =array(); 

        // 获取用户ID，未登录时异常返回
        // $uid = $this->tryToGetUid();

        // 获取app_key，未指定时异常返回
        // $appKey = $this->tryToGetAppKey();

        // TODO: 实现你的业务逻辑……
        // $domain = new JavaHelloDomain();

        // API接口对接（内部接口，或上游接口）
        $apiParams = array(
            'city' => $city, // 
        );
        // TODO: 接口地址，请更换成你需要请求的接口地址
        $apiUrl = 'http://api.xxxx.com/';
        // POST请求
        $curl = new \PhalApi\CUrl();
        $curlRs = $curl->post($apiUrl, $apiParams);
        // GET请求
        // $curlRs = $curl->get($apiUrl . (strpos($apiUrl, '?') ? '&' : '?') . http_build_query($apiParams));
        $rs['backend_data_raw'] = $curlRs;
        $rs['backend_data'] = json_decode($curlRs, true);


        return $rs;

    }

    // 绑定数据库模型
    protected function getDataModel() {
        return new \App\Model\JavaHello();
    }
}

你只需要根据上面生成的代码模板，把内部API接口的路径，填写到$apiUrl这个变量即可。你还可以补充和添加额外的请求参数。