Call Method
All Tencent eSign Open APIs are called via HTTPS. All responses are in JSON format.
Basic Information
Environment Domains
| Environment | Domain | Description |
|---|---|---|
| Test | https://api.test.sign.tencent.com | For development and testing |
| Production (Singapore) | https://sgapi.tencent-esign.com | Region-based, currently Singapore |
Full request URL = Environment domain + API prefix + specific path, e.g.:
https://sgapi.tencent-esign.com/openapi/v1/envelopesRequest Method & Content Type
| Endpoint Type | Method | Request Content-Type |
|---|---|---|
| Business APIs (upload file, create envelope, etc.) | POST | application/json |
| OAuth token endpoints (issue/revoke token) | POST | application/x-www-form-urlencoded |
Business API parameters are passed in the JSON body. OAuth token endpoint parameters are passed as form fields. See Authentication for details.
Operator User
When an app is created, it is automatically associated with a system user ID. You can specify the execution identity via the X-Operator-User-Id header. If omitted, the system user ID is used by default.
Only the Create and Send Envelope endpoint (CreateEnvelope) requires a real user ID — this user will be the envelope sender.
SpaceId
An app (AppId) can be installed in one or more Spaces. When obtaining a token, specify the target Space via the space_id parameter. The issued access_token is valid only for that Space, and all subsequent business API calls are executed within it — no need to pass SpaceId again.
Time Format
All time fields use RFC3339/ISO 8601 format with any timezone offset:
2024-01-15T10:30:00Z(UTC)2024-01-15T18:30:00+08:00(UTC+8)