# essbasic-nodejs-kit

**Repository Path**: tencent_ess/essbasic-nodejs-kit

## Basic Information

- **Project Name**: essbasic-nodejs-kit
- **Description**: 第三方应用集成代码模板示例
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2023-03-23
- **Last Updated**: 2024-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 腾讯电子签第三方应用集成示例

## 简介

本项目基于vue+element-ui+nodejs，是一个集成了腾讯电子签的管理后台，用于快速体验腾讯电子签的第三方应用集成能力。

 为了让您更好地学习并使用腾讯电子签的第三方应用集成，我们提供了一键生成体验应用的云开发模式，基于[CloudStudio](https://ide.cloud.tencent.com/)，您无需准备任何本地环境，无需注册企业和用户，即可1秒钟启动项目，在云上体验和学习。

 在这个模式下，我们帮您创建了一个用于临时体验的腾讯电子签企业，并生成一个临时的法人用户。这样节省了注册企业和用户的成本，让您先接触腾讯电子签的核心能力，先了解腾讯电子签的**第三方应用集成能做什么**，然后我们会一步一步引导您上手开发。


## 体验步骤

此代码示例，包含以下功能：印章管理、模板管理、合同管理；

体验步骤如下：

添加印章 ——> 创建模板 ——> 发起合同 ——> 签署合同（小程序扫码） ——> 预览合同 ——> 下载合同

## 运行步骤

### 初始化安装依赖

```
yarn install
```

### 启动服务

```
yarn start
```
## 配置说明


企业的相关参数会放到`.env.ess`文件中，项目运行时，会自动将其中的参数作为环境变量。

详细的配置说明请参考[通用参数](https://qian.tencent.com/developers/docs/integrations/partner/common_params)

- `X_ESS_ADMINUSERID` 企业法人的userId
- `X_ESS_APPLICATIONID` (第三方应用集成专属)应用Id
- `X_ESS_SECRETID` 腾讯云企业SecretId
- `X_ESS_SECRETKEY` 腾讯云企业SecretKey
- `X_ESS_TOKEN` 接口回调校验签名
- `X_ESS_PROXYORGANIZATIONNAME` 子客企业名称
- `X_ESS_PROXYOPERATOROPENID` 经办人Id
- `X_ESS_PROXYAPPID`  子客唯一应用Id
- `X_ESS_PROXYORGANIZATIONOPENID` 子客企业Id


如果有需要的话，您可以修改.env.ess文件中的配置参数，联调您的真实企业。

## 参考文档

腾讯电子签第三方应用集成

- [快速上手](https://qian.tencent.com/developers/docs/scenes/partner/quickStart)
- [上手必读](https://qian.tencent.com/developers/docs/integrations/partner/integration_app)
- [操作指南](https://qian.tencent.com/developers/docs/scenes/partner/%E6%93%8D%E4%BD%9C%E6%8C%87%E5%8D%97/%E5%88%9B%E5%BB%BA%E9%9B%86%E6%88%90%E5%BA%94%E7%94%A8)
- [API文档](https://qian.tencent.com/developers/docs/apis/partnerApis)

腾讯电子签官方

- [腾讯电子签官网](https://qian.tencent.com)

- 小程序

![](https://qcloudimg.tencent-cloud.cn/raw/166706a42851698917fee43832704f47.png)