电子签名API集成：开发人员最佳实践

将电子签名集成到您的应用程序中不应该很复杂。无论您是在构建合同管理系统、HR门户还是自定义业务应用程序，本指南都向您展示如何实现防弹电子签名工作流。

API架构概述

RESTful设计原则

Space Sign的API遵循REST最佳实践：

**基础URL：** https://api.spacesign.com/v1

认证： Bearer令牌

http

1Authorization: Bearer YOUR_API_KEY

响应格式： JSON

json

1{
2  "status": "success",
3  "data": { ... },
4  "meta": { ... }
5}

核心集成工作流

1. 发送文档进行签名

基本流程：

1. 上传文档

2. 定义签名者

3. 放置签名字段

4. 发送签名

代码示例（Node.js）：

javascript

1const SpaceSign = require('@spacesign/sdk');
2
3const client = new SpaceSign({ apiKey: process.env.SPACESIGN_API_KEY });
4
5async function sendContract() {
6  try {
7    // 步骤1：上传文档
8    const document = await client.documents.upload({
9      file: './contract.pdf',
10      title: '雇佣协议 - 张三'
11    });
12
13    // 步骤2：添加签名者
14    const envelope = await client.envelopes.create({
15      documentId: document.id,
16      signers: [
17        {
18          email: 'zhangsan@example.com',
19          name: '张三',
20          role: '员工',
21          order: 1
22        }
23      ]
24    });
25
26    // 步骤3：发送信封
27    const sent = await client.envelopes.send(envelope.id);
28
29    console.log(`信封已发送！ID: ${sent.id}`);
30    return sent;
31
32  } catch (error) {
33    console.error('发送合同错误:', error);
34    throw error;
35  }
36}