Skip to content

Open API

Open API issues credentials to external systems. The caller exchanges APPID + Secret for an erupt token, then calls protected erupt APIs, including CRUD on any Erupt class, with the permissions of the bound user.

Compared with sharing someone's account and password, a credential can be revoked at any time, carries its own token lifetime, shows the full secret only once at creation, and gives every integrator its own auditable record.

Fields

FieldDescription
APPIDGenerated: es prefix + 14 random characters
NameIdentifies the integrator, e.g. "ERP Sync"
Token Validity PeriodMinutes, default 3600
Bind User PermissionsAPI calls run with this user's menu permissions and data scope. Create a least-privilege user per integrator
StatusDisabling immediately invalidates any issued token
Secret KeyGenerated 24-character uppercase string. The list shows only the first and last 4 characters, the rest masked with *

Secret Management

  • The Update Secret Key row operation generates a new secret, shows it once in a popup, and invalidates the old one immediately.
  • Disabling or deleting a record also logs out its issued token.

Call Flow

Endpoints, parameters and sample code: Open API →

Contributors

The avatar of contributor named as YuePeng YuePeng
The avatar of contributor named as Claude Opus 5 (1M context) Claude Opus 5 (1M context)

Changelog

Released under the Apache-2.0 License.