@alipay-inc/mpaas-ide-openapi

mPaaS IDE openAPI

接口说明

阿里云

• https://help.aliyun.com/document_detail/178983.html

私有云

• 请联系PDSA

接口返回数据标准

{
  data:      '<any>',     // 返回数据
  errorCode: '<string>',  // 错误代码，非必选
  requestId: '<string>',  // 请求ID，非必选
  resultMsg: '<string>',  // 当success !== true，必选
  success:   '<boolean>', // 是否正确返回
  ...                     // 各环境自定义字段
}

配置文件

• 从控制台下载配置文件 config

  • 阿里云openapi，需要开通ak. https://help.aliyun.com/document_detail/175967.htm?spm=a2c4g.11186623.0.0.2bf41dcfwOHEGC

    • 并自行完善配置文件

    • {
        ...配置文件内容,
        "openapi": {
          "type":            'aliyun',                             // 必填、固定值
          "userId":          '<string>',                           // 必填、字母数字下划线
          "accessKeyId":     '<阿里云 AccessKey ID>',               // 必填
          "accessKeySecret": '<阿里云 AccessKey Secret>',           // 必填
          "endpoint":        'mpaas.cn-hangzhou.aliyuncs.com',     // 必填、固定值
        }
      }
      

  • 私有化openapi，需要配置rsa

    • {
        ...配置文件内容,
        "openapi": {
          "type":            'antfin',                             // 必填、固定值
          "userId":          '<string>',                           // 必填、字母数字下划线
          "privateKey":      '<私钥 string format>',                // 必填 https://www.samltool.com/format_privatekey.php
          "api_url":         '<私有云api地址>'                       // 必填
        }
      }
      

使用方法

• // 引入依赖
  const Client = require('@alipay-inc/mpaas-ide-openapi').default;
  // 引入配置文件
  const config = '<上文中的配置文件>';
  // 创建实例
  const {
    client
  } = new Client(config);
  // 发起请求
  (async () => {
    const result = await client.getAppListByApi();
    console.log(result);
  }());
  

API

getAppListByApi 拉取小程序列表

• 入参 -

• 返回

  • {
      data: [
       {
          appCode:     '<string>',
          gmtCreate:   '<string>'
          gmtModified: '<string>',
          h5Id:        '<string>',
          h5Name:      '<string>',
         ...
        },
        ...
      ],
      errorCode: 'OK',
      requestId: '<string>',
      resultMsg: '',
      success:   true
    }
    

getPackageInfoByApi 拉取小程序配置

• 若此小程序从未发布过，则读取默认配置

• 入参

  • {
      h5Id:         '<string>',  // 必填，小程序ID
      h5Name:       '<string>',  // 必填，小程序名称
      packageTypes: '<string>'   // 可选，默认 '1,2,3,4'
    }
    

• 返回

  • {
      data:      '<object>',
      errorCode: 'OK',
      requestId: '<string>',
      resultMsg: '',
      success:   true
    }
    

uploadPackageByApi 上传小程序并发布

• 上传小程序包之前，需要检测是否配置虚拟域名，若未配置，则报错

• 预览调试包上传并发布，正式包只上传

• 调试包上传之前需要检测是否有白名单，若无白名单，则直接报错返回

• 入参

  • {
      appInfo:        '<object>',  // 必填，小程序配置
      packageType:    '<string>',  // 必填，包类型（1,2 为正式包。3,4 为测试包）
      resourceFile:   '<string>',  // 必填，小程序包的本地绝对路径
      iconFile:       '<string>',  // 选填，小程序图标的本地绝对路径
      h5Version:      '<string>',  // 选填，版本号（若传入，则使用此版本号。若未传入，则使用appInfo.h5Version + packageType生成新的版本号）
      whitelistValue: '<string>',  // 选填，白名单（若packageType === '3' || '4'，则为测试包，需要白名单）
      sourceCodeFile: '<string>',  // 选填，源码包本地的压缩包地址
    }
    

• 返回

  • {
      data:      '<string>',
      // packageType === 3 || 4。"{&quot;debugUrl&quot;:&quot;mpaas://platformapi/startapp?appId=20001101&amp;token=ide_qr&amp;scheme=mpaas%3A%2F%2Fplatformapi%2Fstartapp%3FappId%3D1234567890123456%26nbsv%3D1.4.25.62%26nbsource%3Ddebug%26nbprefer%3DYES%26nbsn%3DDEBUG%26nboffline%3Dsync%26nbtoken%3Dide_qr%26enableBugme%3Dfalse%26chInfo%3Dch_scan%26channelId%3Dnull%26enablePolyfillWorker%3D%26isRemoteDebug%3Dfalse%26enableBugme%3Dfalse%26websocketUrl%3Dwss%3A%2F%2Fcn-hangzhou-mproxy.cloud.alipay.com&quot;,&quot;userId&quot;:&quot;shengyong_zhu&quot;}"
      // packageType === 1 || 2。 "发布ID"
      errorCode: 'OK',
      requestId: '<string>',
      resultMsg: '',
      success:   true
    }
    

公共API

cloudBuild 云构建小程序

• 入参

  • {
      file:         '<string>', // 必填，本地amr文件路径
      config:       '<object>', // 必填，配置文件
      h5Id:         '<string>', // 必填，mPaaS小程序ID
    }
    

• 返回

  • {
      data: {
        file:       '<string>',  // 本地根据h5Id生成的mPaaS zip文件，可以直接从控制台上传
        originFile: '<string>'   // 云构建原始文件
      },
      success:      true
    }
    

getZipFromTar 将本地IDE/mpaasu构建后的小程序tar文件转为mPaaS格式的zip文件

• 入参

  • {
      tarFilePath:  '<string>', // 必填，本地tar文件
      h5Id:         '<string>'  // 必填，mPaaS小程序ID
    }
    

• 返回

  • {
      data:         '<string>',  // 转换后的zip文件本地路径
      success:      true
    }