Lovrabet API URL rule changes

📢 Important change notice

In one sentence:

INFO

Starting 2025-09-12, Lovrabet switches to its new brand domain, Lovrabet.com. To simplify the API architecture, the previous smartapi/dbapi dual calling convention has been unified into a single api interface, the domain has been migrated, and the URL path structure simplified. Quick replacement guide: Replace all occurrences of https://api.yuntooai.com/smartapi/runtime/[tenantCode]/https://api.yuntooai.com/dbapi/runtime/[tenantCode]/ with https://runtime.lovrabet.com/api/

Effective date: 2025-09-12

Impact: all partners and developers calling Lovrabet APIs

Full details below: ↓

---

🔄 API URL rule changes

Old rule (deprecated)

- https://api.yuntooai.com/{callMethod}/runtime/{tenant}/{appCode}/{datasetCode}/{apiName}

Parameters:

• callMethod: API call type (smartapi/dbapi) ❌ Removed
• runtime: fixed prefix, runtime identifier ❌ Removed
• tenant: tenant name ❌ Removed
• appCode: app code
• datasetCode: dataset code
• apiName: API name

Example:

- https://api.yuntooai.com/dbapi/runtime/yuntoo/app-f4c03acb/6c6c94a6ef064fe898cfa895fe5a38f5/getList

New rule (current)

+ https://runtime.lovrabet.com/api/{appCode}/{datasetCode}/{apiName}

Parameters:

• api: fixed prefix (used uniformly by all APIs) ✅ New
• appCode: app code (format: app-{app ID})
• datasetCode: unique dataset identifier
• apiName: the specific API name

Example:

+ https://runtime.lovrabet.com/api/app-c4055413/76a873945291498498737bc85677983d/getList

📋 Change comparison

Item	Old rule	New rule	Notes
URL structure	6 path segments	4 path segments	Simpler URL structure
Calling convention	smartapi/dbapi split	unified api	Simpler calling convention
Fixed prefix	runtime	api	A more intuitive prefix
Tenant identifier	tenant name required	Not needed	The Lovrabet platform resolves it, less complexity for developers
App code	app-	app-	Unchanged
Dataset code	Unchanged	Unchanged	Unchanged
API name	Unchanged	Unchanged	Unchanged

🛠️ What you need to change

Update API request URLs

Old code:

const apiUrl =
- "/dbapi/runtime/yuntoo/app-f4c03acb/6c6c94a6ef064fe898cfa895fe5a38f5/getList";
const response = await fetch(`https://api.yuntooai.com${apiUrl}`);

New code:

const apiUrl =
+ "/api/app-c4055413/76a873945291498498737bc85677983d/getList";
const response = await fetch(`https://runtime.lovrabet.com${apiUrl}`);

Update configuration files

If a configuration file stores your API URL template, update it:

Old template:

{
- "apiTemplate": "/{callMethod}/runtime/{tenant}/{appCode}/{datasetCode}/{apiName}"
}

New template:

{
+ "apiTemplate": "/api/{appCode}/{datasetCode}/{apiName}"
}

Update API parsing logic

If your code parses API URLs:

Old parsing logic:

const urlParts = apiUrl.split("/");
- const callMethod = urlParts[1]; // smartapi/dbapi
- const runtime = urlParts[2]; // runtime
- const tenant = urlParts[3]; // 租户名称
- const appCode = urlParts[4]; // 应用代码
- const datasetCode = urlParts[5]; // 数据集代码
- const apiName = urlParts[6]; // 接口名称

New parsing logic:

const urlParts = apiUrl.split("/");
+ const apiPrefix = urlParts[1]; // api (固定)
+ const appCode = urlParts[2]; // 应用代码
+ const datasetCode = urlParts[3]; // 数据集代码
+ const apiName = urlParts[4]; // 接口名称

⚠️ Important reminders

Test and verify

After updating API URLs, make sure to verify:

• ✅ API calls succeed
• ✅ Response data format is unchanged
• ✅ Permission checks pass
• ✅ Error handling works

Permissions

• The permission verification mechanism is unchanged under the new rule
• You still need to sign in at app.lovrabet.com to obtain permissions
• Cross-origin requests still require credentials: 'include'

🔗 Get the new API URLs

Option 1: From the admin console

1. Visit https://app.lovrabet.com/app/{yourAppCode}/admin/dataset
2. Find the dataset you need
3. Copy the API URL in the new format

Option 2: Convert the URL

If you have an API URL in the old format, convert it as follows:

Conversion rule:

- 原: https://api.yuntooai.com/{callMethod}/runtime/{tenant}/{appCode}/{datasetCode}/{apiName}
+ 新: https://runtime.lovrabet.com/api/{appCode}/{datasetCode}/{apiName}

Conversion example:

- 原: https://api.yuntooai.com/dbapi/runtime/yuntoo/app-f4c03acb/6c6c94a6ef064fe898cfa895fe5a38f5/getList
+ 新: https://runtime.lovrabet.com/api/app-f4c03acb/6c6c94a6ef064fe898cfa895fe5a38f5/getList

API usage examples

For API usage examples, see the official demo at https://github.com/lovrabet-ai/sub-app-react-demo

📝 Update checklist

After updating your API URLs, run through this checklist:

• [ ] All API request URLs updated to the new format

• [ ] Related configuration files updated

• [ ] API URL parsing logic updated

• [ ] Tests pass in your local environment

• [ ] Verified in production

• [ ] Error handling works correctly

• [ ] Permission verification works correctly

• [ ] User documentation updated (if any)

---

Last updated: September 12, 2025

Version: v2.0