Mulai Amplop dengan Cepat

POST /esignglobal/v1/envelope/createAndStart

Deskripsi Antarmuka

Dengan cepat memulai amplop, termasuk membuat amplop, menambahkan dokumen yang akan ditandatangani, menambahkan penandatangan, dan fungsi lainnya.

Mendukung pembukaan otomatis：Setelah panggilan antarmuka berhasil, amplop berhasil dibuat dan dibuka, dan amplop secara otomatis mulai beredar.
Mendukung pengakhiran otomatis：Setelah semua pihak penandatangan menyelesaikan penandatanganan, amplop secara otomatis diakhiri.

Parameter Permintaan

Nama Parameter					Tipe	Wajib Diisi	Keterangan
subject					string	true	Subjek Amplop Contoh: “Offer Letter”
remark					string	false	Catatan Amplop，Batas panjang 1000 karakter
signerSettings					object	false	Operasi yang diizinkan untuk penandatangan
	allowTransfer				boolean	false	Apakah penandatangan diizinkan untuk meneruskan amplop ini ke orang lain untuk ditandatangani, defaultnya adalah false true-Penandatangan dalam amplop memiliki hak untuk meneruskan amplop ke orang lain; false-Penandatangan dalam amplop tidak memiliki hak untuk meneruskan amplop ke orang lain;
	allowModifyName				boolean	false	Apakah pihak penandatangan diizinkan untuk mengubah nama, hanya berlaku untuk tanda tangan templat, defaultnya adalah false true-Penandatangan diizinkan untuk mengubah nama false-Penandatangan tidak diizinkan untuk mengubah nama
expireAfterSeconds					long	false	Waktu kedaluwarsa amplop, setelah berapa detik amplop akan kedaluwarsa Rentang kedaluwarsa: 86.400 detik (1 hari) ~ 7.776.000 detik (90 hari)
redirectUrl					string	false	Harus berupa alamat https yang valid
callBackUrl					string	false	Alamat panggilan balik (panjang 500), harus sesuai dengan alamat protokol https.
sendLaterAfterSeconds					long	false	Mendukung pengguna untuk menunda pengiriman, dalam satuan detik Rentang waktu yang didukung: 3600 detik (1 jam) ~ 259200 detik (30 hari)
CCInfos					array	false	Kumpulan informasi penerima tembusan
	userEmail				string	false	Alamat email penerima tembusan
	userName				string	false	Nama CC, digunakan untuk menampilkan nama CC di halaman penandatanganan dan amplop. 【Perhatian】: Tidak boleh mengandung 9 karakter khusus berikut: / \ : * " < > \| ？dan semua emoji
	customizeSettings				object	false	Konfigurasi khusus
		notificationSettings			object	false	Konfigurasi khusus tipe notifikasi
			notificationLanguage		string	false	Bahasa notifikasi, defaultnya adalah bahasa Inggris en-US Bahasa Inggris zh-CN Bahasa Mandarin Sederhana zh-Hant Bahasa Mandarin Tradisional ja-JP Bahasa Jepang ES-MX Bahasa Spanyol
signFiles					array	true	Kumpulan informasi dokumen yang ditandatangani, urutan tampilan adalah urutan penambahan file.
	fileKey				string	true	fileKey dokumen yang ditandatangani, hanya mendukung format PDF
attachments					array	false	Kumpulan lampiran amplop, urutan tampilan adalah urutan penambahan file.
	fileKey				string	false	fileKey file
signerInfos					array	true	Kumpulan informasi penandatangan
	businessId				string	false	Nomor bisnis yang ditentukan pengembang, batasan panjang 500
	deliveryMethods				string	false	Metode notifikasi, defaultnya adalah auto auto-Kirim notifikasi email saat userEmail diteruskan, kirim notifikasi SMS saat phoneNumber diteruskan none-Jangan kirim notifikasi pesan email-Kirim notifikasi email sms-Kirim notifikasi SMS WhatsApp-Kirim notifikasi WhatsApp
	userEmail				string	true	Alamat email penandatangan
	userName				string	true	Nama penandatangan, digunakan untuk menampilkan nama penandatangan di halaman penandatanganan dan amplop. 【Catatan】Tidak boleh mengandung 9 karakter khusus berikut: / \ : * " < > \| ？dan semua emoji
	phoneNumber				object	false	Nomor telepon, defaultnya kosong Parameter ini wajib diisi saat notifikasi SMS diperlukan, countryCode dan number harus diteruskan
		countryCode			string	false	Kode internasional negara/wilayah, tidak perlu meneruskan “+”
		number			string	false	Tidak ada validasi format, hanya batasan panjang maksimum 13 digit
	customizeSettings				object	false	Konfigurasi khusus
		notificationSettings			object	false	Konfigurasi Kustom Tipe Pemberitahuan
			customizeMessage		string	false	Pemberitahuan pesan eksklusif, batas karakter 200
			notificationLanguage		string	false	Bahasa pemberitahuan, defaultnya adalah bahasa Inggris en-US Bahasa Inggris zh-CN Bahasa Mandarin Sederhana zh-Hant Bahasa Mandarin Tradisional ja Bahasa Jepang ES-MX Bahasa Spanyol
	signOrder				int	true	Urutan penandatanganan penanda tangan, minimal 1. Penandatanganan tidak berurutan dapat menentukan nilai urutan yang sama.
	anySigner				boolean	false	Apakah mendukung penandatanganan oleh siapa pun, defaultnya false true-Hanya satu orang yang perlu menandatangani dengan signOrder yang sama false-Semua orang dengan signOrder yang sama harus menandatangani
	authModes				string	false	Metode verifikasi, defaultnya adalah noAuth noAuth-Tidak diverifikasi accessCode-Verifikasi menggunakan kata sandi penandatanganan sms- Verifikasi OTP SMS idVerification- Verifikasi Dokumen Identitas emailAuth- Verifikasi OTP Email digitalId- Verifikasi Identitas Elektronik
	authConfig				object	false	Pengaturan Metode Verifikasi
		accessCode			object	false	Pengaturan Kata Sandi Penandatanganan, wajib diisi ketika authModes=accessCodewajib diisi
			accessCode		string	false	Isi kata sandi, tidak membedakan huruf besar dan kecil, dapat berisi huruf dan angka, batasan panjang 45
			promptInfo		string	false	Informasi petunjuk kata sandi akses, tidak boleh berisi kata sandi akses, batasan panjang 30, wajib diisi ketika authModes=1.
		sms			object	false	Verifikasi OTP SMS, wajib diisi ketika authModes=smswajib diisi
			countryCode		string	false	Kode internasional negara/wilayah, tidak perlu memasukkan “+”
			number		string	false	Tidak melakukan verifikasi format, hanya membatasi panjang maksimum 13 digit
		idVerification			object	false	Pengaturan verifikasi dokumen identitas, wajib diisi ketika authModes=idVerificationwajib diisi
			name		string	false	Nama lengkap pada kartu identitas penandatangan, panjang maksimum 100 karakter
		emailAuth			object	false	Verifikasi OTP email, ketika authModes=emailAuthwajib diisi
			authEmail		string	false	Alamat email verifikasi identitas penandatangan
		digitalId			array	false	Verifikasi identitas elektronik, wajib diisi ketika authModes=digitalId
			authApp		string	false	APP yang digunakan untuk verifikasi identitas elektronik singpass-Gunakan Singpass untuk otentikasi
			idNumber		string	false	Nomor kartu identitas penandatangan yang akan diverifikasi
	digitalSignature				boolean	false	Apakah akan mengaktifkan tanda tangan digital, default false true-Aktifkan, false-Tidak diaktifkan
	freeFormSign				boolean	false	Apakah penandatangan dapat membubuhkan stempel secara bebas, nilai default false Catatan tambahan: Ketika freeFormSign dipilih sebagai true, parameter lain di bawah sealInfos tidak perlu diteruskan. Jika diteruskan secara bersamaan, prioritas freeFormSign lebih tinggi dari sealInfos, dan parameter di bawah sealInfos tidak akan berlaku [Perhatian]Tanda tangan bebas berarti tidak ada batasan jumlah dan posisi stempel/tanda tangan yang dapat diseret oleh penandatangan
	sealInfos				array	false	Informasi Tugas Penandatanganan
		fileKey			string	true	Tandatangani file fileKey
		signConfigs			array	false	Informasi lokasi kontrol, informasi lokasi kontrol harus ditentukan untuk melakukan tanda tangan elektronik.
			fieldType		string	false	Jenis kontrol, defaultnya adalah signature signature-Kontrol tanda tangan stamp-Kontrol stempel approval-Kontrol persetujuan
			sizeRule		string	false	Cara menampilkan ukuran area penandatanganan originalSize-Letakkan stempel sesuai dengan ukuran sebenarnya dari tanda tangan/stempel targetSize-Kustomisasi tinggi dan lebar area tanda tangan/stempel Ketika sizeRule, height, width semuanya kosong, stempel akan diletakkan sesuai dengan ukuran sebenarnya dari tanda tangan/stempel; Ketika sizeRule kosong, height, width tidak kosong, stempel akan diletakkan sesuai dengan ukuran yang ditentukan; Ketika sizeRule tidak kosong, stempel akan diletakkan sesuai dengan metode tampilan yang ditentukan.
			height		int	false	Tinggi kontrol penandatanganan, berlaku untuk fieldType signature/stamp, satuan dalam px, hanya mendukung input bilangan bulat positif, defaultnya adalah auto (yaitu ukuran otomatis sistem); Ketika fieldType=signature, rentang yang dapat diatur adalah 20-250px; Ketika fieldType=stamp, rentang yang dapat diatur adalah 30-280px;
			width		int	false	Lebar kontrol penandatanganan, berlaku untuk fieldType signature/stamp, satuan dalam px, hanya mendukung input bilangan bulat positif, defaultnya adalah auto (yaitu ukuran otomatis sistem); Ketika fieldType=signature, rentang yang dapat diatur adalah 20-250px; Ketika fieldType=stamp, rentang yang dapat diatur adalah 30-280px;
			signatureOptions		string	false	Opsi kontrol tanda tangan. Hanya berlaku untuk fieldType signature Parameter yang dapat dimasukkan: template: Tanda tangan template handDrawn: Tanda tangan gambar tangan upload: Unggah gambar tanda tangan lokal Dapat memilih beberapa, dipisahkan dengan ",", defaultnya adalah pilih semua
			movable		boolean	false	Izinkan memindahkan posisi saat menandatangani, defaultnya adalah false false-Tidak mengizinkan penandatangan untuk menyesuaikan posisi kontrol penandatanganan mereka sendiri true-Mengizinkan penandatangan untuk menyesuaikan posisi kontrol penandatanganan mereka sendiri
			allowedOptions		array	false	Opsi yang diizinkan untuk disetujui oleh penandatangan, berlaku untuk fieldType approval. Defaultnya adalah ["approve", "decline"] approve-Setuju decline- Tolak
			pageNo		string	false	Halaman tanda tangan; halaman berurutan dihubungkan dengan "-", halaman terpisah dihubungkan dengan "," Contoh: 1-3,6-10
			posX		float	false	Koordinat sumbu x [Catatan] Jika fieldType adalah signature, maka posisi koordinat mengacu pada area tanda tanganKiri bawah； Jika fieldType adalah stamp, maka posisi koordinat mengacu pada area stempelTitik tengahPosisi Mulai 3 Februari 2026, fieldType adalah signature atau stamp, posisi koordinatnya mengacu pada posisi titik tengah area stempel.
			posY		float	false	Koordinat sumbu y [Catatan] Jika fieldType adalah signature, maka posisi koordinat mengacu pada area tanda tanganKiri bawah； Jika fieldType adalah stamp, maka posisi koordinat mengacu pada area stempelTitik tengahPosisi Mulai 3 Februari 2026, fieldType untuk tanda tangan atau stempel, posisi koordinatnya mengacu pada posisi titik tengah area stempel.
		fillConfigs			array	false	Isi informasi kontrol
			fieldName		string	false	Nama kontrol, batasan jumlah karakter 128
			required		boolean	false	Apakah wajib diisi, defaultnya wajib diisi true-Wajib diisi false-Tidak wajib diisi
			fieldType		string	false	Tipe kontrol: 1-Teks satu baris 15-Kotak centang
			textField		object	false	Properti kontrol teks
				overflowType	int	false	Hanya berlaku untuk teks, defaultnya 1 1-Otomatis perkecil ukuran font 2-Batasi input
				minFontSize	float	false	Hanya berlaku untuk teks, hanya berlaku untuk overflowType=1, defaultnya 8 5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72
				width	int	false	Lebar kontrol, default 160px
				font	int	false	Hanya berlaku untuk teks, jenis huruf, default SimSun 1-SimSun 2-NSimsun 4-Heiti 5-Kaiti 6-Arial 7-Helvetica 9-Times New Roman 10-Fangsong 11-Georgia 12-Monospace
				fontSize	float	false	Hanya berlaku untuk teks, ukuran huruf, default 12 5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72
				textColor	string	false	Hanya berlaku untuk teks, warna heksadesimal, default hitam #000
				bold	boolean	false	Hanya berlaku untuk teks, apakah huruf tebal, default false true-Tebal false-Tidak tebal
				italic	boolean	false	Hanya berlaku untuk teks, apakah miring, default false true-Miring false-Tidak miring
				underline	boolean	false	Hanya berlaku untuk teks, apakah font ditambahkan garis bawah, defaultnya false true-Tambahkan garis bawah false-Jangan tambahkan garis bawah
				lineThrough	boolean	false	Hanya berlaku untuk teks, apakah ditambahkan garis coret, defaultnya false true-Tambahkan garis coret false-Jangan tambahkan garis coret
				horizontalAlignment	string	false	Hanya berlaku untuk teks, format rata tengah horizontal, defaultnya left LEFT-Rata kiri CENTER-Rata tengah RIGHT-Rata kanan
			tickBoxField		object	false	Properti kotak centang
				tickOptions	array	false	Hanya berlaku untuk tickBox, defaultnya 1 1-Centang 2-Silang
			posX		float	false	Koordinat X horizontal posisi kontrol
			posY		float	false	Koordinat Y vertikal posisi kontrol
			pageNo		string	false	Nomor halaman tempat kontrol berada
		signDateConfigs			array	false	Informasi posisi tanggal penandatanganan
			movable		boolean	false	Izinkan pemindahan posisi saat menandatangani, defaultnya false false - tidak mengizinkan penandatangan untuk menyesuaikan posisi kontrol penandatanganan mereka sendiri true - mengizinkan penandatangan untuk menyesuaikan posisi kontrol penandatanganan mereka sendiri
			pageNo		string	false	Nomor halaman penandatanganan; nomor halaman berurutan dihubungkan dengan "-", nomor halaman terpisah dihubungkan dengan ","，Contoh: 1-3, 6-10; Jika tidak berurutan, masukkan "," untuk memisahkannya.
			posX		float	false	Offset sumbu x, sudut kiri bawah halaman adalah titik asal koordinat
			posY		float	false	Offset sumbu y, sudut kiri bawah halaman adalah titik asal koordinat
			signDateFormat		string	false	Format tanggal penandatanganan, format defaultnya adalah yyyy-MM-dd Mendukung format yang ditentukan: yyyy年MM月dd日 yyyy-MM-dd yyyy/MM/dd dd.MM.yyyy MM dd yyyy dd MM yyyy

Contoh permintaan

{
    "subject": "员工入职合约",
    "remark": "这是描述",
    "expireAfterSeconds": 86400,
    "redirectUrl": "https://app-sml.esignglobal.com/home/main/esign/contract/list/inbox",
    "signFiles": [
      {
        "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
      },
      {
        "fileKey": "$c7567683-2fc1-47a5-82c1-570d4839afd8$3119805980"
      }
    ],
    "signerInfos": [
      {
        "userEmail": "sender_user@tsign.cn",
        "userName": "sender_user_name",
        "phoneNumber": {
        	"countryCode": "86",
        	"number": "158****9242"
        }
        "signOrder": 1,
        "authModes": "sms",
        "authConfig": {
            "sms": {
                "countryCode": "86",
                "number": "158****9242"
            }
        },
        "sealInfos": [
        {
            "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c",
            "signConfigs": [
              {
                "fieldType": "stamp",
                "pageNo": "1,3-5",
                "posX": 100.22222,
                "posY": 100.11111
              }
              "fillConfigs": [
              {
                "fieldId": "df0dd777bc774a2ba3fec4d108de242d",
                "fieldKey": "必填单行文本自动缩小字号最小字号Arial",
                "pageNo": "1",
                "posX": "88.70021",
                "posY": 745.409,
                "fieldType": "1",
                "required": true,
                "textField": {
                    "overflowType": "1",
                    "minFontSize": 8,
                    "font": "6",
                    "fontSize": "12",
                    "textColor": "#54ACD2",
                    "bold": false,
                    "italic": true,
                    "lineThrough": false,
                    "horizontalAlignment": "RIGHT"
                }
              },
              {
                  "fieldId": "888b899853544c49bd819d9f6d1e52cf",
                  "fieldKey": "必填勾选控件不限制选中样式不显示边框",
                  "pageNo": "3",
                  "posX": 451.77127,
                  "posY": 429.07626,
                  "fieldType": "15",
                  "required": true,
                  "tickBoxField": {
                      "tickOptions": [1,2],
                      "showBorder": false
                  }
                }
              ]
            ],
            "signDateConfigs":[
              {
                "pageNo":"1",
                "posX": 100.22,
                "posY": 100,
                "signDateFormat": "dd MMM yyyy"
              }
            ]
        }
      ]
    }
  ]
}

Parameter respons

Nama Parameter		Jenis	Deskripsi
envelopeId		string	ID Amplop
CCInfos		array	Kumpulan informasi penerima tembusan
	userEmail	string	Alamat email penerima tembusan
	userName	string	Nama penerima tembusan
signFiles		array	Kumpulan informasi dokumen yang ditandatangani
	fileKey	string	fileKey dokumen yang ditandatangani
attachments		array	Kumpulan lampiran amplop
	fileKey	string	fileKey file
signerInfos		array	Informasi penandatanganan
	businessId	string	Nomor bisnis khusus pengembang, batasan panjang 500
	userEmail	string	Alamat email penandatangan
	userName	string	Nama Penandatangan
	signUrl	string	Tautan Alamat Penandatanganan
	signOrder	int	Urutan penandatanganan penandatangan, minimal 1
	accessCode	string	Kata sandi akses halaman penandatanganan

Contoh respons

{
  "code": "0",
    "data": {
    "signerInfos": [
      {
        "accessCode": "123456",
        "userEmail": "sender_user@tsign.cn",
        "signUrl": "http://app-test.esignglobal-inc.com/home/main/sign/start/base/dosign?envelopeId=4cd738a60225445f9d5f3afec468a639&signature=eyJhbGciOiJIUzI1NiIsInppcCI6IkRFRiJ9.eNqqVkrOzytJrShRsqpWSs0rS83JL0gNSSzO9kxRslJKtjC1MDKxTDVIMzA0SU4xSTIwNjAxSDRNTTVKMTIxTFOqrQUAAAD__w.YMBA5X9O8Ylk7x2rma-s1WxGwo2cjqy-O9CCQopzw88&tenantToken=AA0DDgQ0Y2Q3MzhhNjAyMjU0NDVmOWQ1ZjNhZmVjNDY4YTYzuQ4GNGNkNzM4YTYwMjI1NDQ1ZjlkNWYzYWZlYzQ2OGE2M7kOCjRjZDczOGE2MDIyNTQ0NWY5ZDVmM2FmZWM0NjhhNjO5AIBjNDIwMzg1ZDMyYzU0MGE4YTk1ZTE3ZTNkZmZjMDNm4g%3D%3D",
        "userName": "sender_user_name",
        "signOrder": "1"
      }
    ],
      "signFiles": [
      {
        "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
      },
      {
        "fileKey": "$c7567683-2fc1-47a5-82c1-570d4839afd8$3119805980"
      }
    ],
      "envelopeId": "4cd738a60225445f9d5f3afec468a639"
  },
  "message": "success"
}