{"id":2221,"date":"2026-09-04T12:25:45","date_gmt":"2026-09-04T12:25:45","guid":{"rendered":"https:\/\/kourentzes.com\/konstantinos\/?p=2221"},"modified":"2026-09-04T12:27:16","modified_gmt":"2026-09-04T12:27:16","slug":"soft1-web-services-metadata-services","status":"publish","type":"post","link":"https:\/\/kourentzes.com\/konstantinos\/index.php\/2026\/09\/04\/soft1-web-services-metadata-services\/","title":{"rendered":"Soft1 Web Services: Metadata Services"},"content":{"rendered":"\n

Beyond the standard data read\/write services (getData<\/code>, setData<\/code>, SqlData<\/code>, etc.), Soft1 Web Services expose a set of services that return metadata<\/strong> about an installation: which objects exist, which tables make up each object, which fields each table has, which gadgets are available, and what access rights a user has on a given object.<\/p>\n\n\n\n

These services are particularly useful when building integrations, because they let a developer discover the structure of a Soft1 installation dynamically, without needing database access or the Designer.<\/p>\n\n\n\n

General<\/h2>\n\n\n\n

All calls are made with HTTP POST<\/strong> to the endpoint:<\/p>\n\n\n\n

https://[SerialNumber].oncloud.gr\/s1services<\/code><\/pre>\n\n\n\n
The request body is JSON and always contains:<\/p>\n\n\n\n
Parameter<\/th>Description<\/th><\/tr><\/thead>
service<\/code><\/td>The name of the service being called<\/td><\/tr>
clientID<\/code><\/td>The token returned by the login<\/code> \/ authenticate<\/code> flow<\/td><\/tr>
appId<\/code><\/td>The application ID (e.g. 1199<\/code>)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Every response contains a success<\/code> field (true<\/code>\/false<\/code>) and, depending on the service, the corresponding data.<\/p>\n\n\n\n
\n
Note:<\/strong> In the examples below the clientID<\/code> is shortened for readability.<\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
1. getObjects \u2014 List of objects<\/h2>\n\n\n\n
Returns all objects available in the installation, with their name, type and caption.<\/p>\n\n\n\n
Reque<\/strong>st<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span>