Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Remote services (expservices)

What the remote services of Exponential (the expservices extension) mean for a site owner - the administration's functions as named HTTP services for scripts, apps and portals, the same permissions as the person…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/customers/growth/remote-services-expservices.md

On this page

Remote services (expservices)

This page is for owners whose partner or own staff want to automate work on the site: a script that imports products every night, a dashboard that reads figures, a portal front end, a desktop or phone app for editors. The extension expservices turns the administration's functions into over a thousand named services, called over HTTP and answering JSON (Remote services and apps). It is part of the default distribution.

Contents

  1. What it is, in owner's terms
  2. What keeps it safe
  3. Tokens
  4. What to agree before anyone uses it
  5. Switching it off

What it is, in owner's terms

A service is called by name, exp<domain>::<method>, under /ezjscore/call/ (Remote services). The services cover:

GroupExamples
Coresession, system, settings (read), caches, cronjobs, extensions, packages, workflows
Contentnodes, objects, classes, versions, translations, relations, trash, sections, states, URL aliases, search, content jobs
Users and accessusers, groups, roles, policies, sessions, preferences, notifications
Commerce, community, feedsproducts, basket and checkout, orders, VAT, currencies, discounts, collected forms, RSS
Media and otherimages, files, tags, layouts, audit (read only), newsletters, sitemaps, statistics

Sample portal front ends built on the services ship in the extension (Remote services). For reading content into a separate app, the REST API may be the simpler choice (The REST API for owners).

What keeps it safe

From Remote services:

  • Each service is public, needs a signed-in user, or needs a policy; without login it answers 401, without the policy 403. A script can never do more than the account it uses.
  • Writes need POST, the form token and the policy, and every successful write is recorded in the audit trail as service.<domain>.<method>.
  • Large operations are routed to content jobs, which run in the background in batches.
  • No write is open without a policy.

Tokens

A signed-in user can create a personal token for a script: it is shown once, only its hash is stored, it lasts 1 to 365 days (90 by default), and requests with it run with the same policies as the user. Expired, revoked or disabled-user tokens answer 401, and a token cannot create tokens. Creating, revoking and failed use go to the audit trail (Remote services).

Tip

As with API keys: give each script its own account with a narrow role, and a token with an expiry. A token on a person's administrator account can do everything that person can.

What to agree before anyone uses it

QuestionYour answer
Which tasks will be automated?
Which account and role does each script use?
Read only, or writes?
When does each token expire, and who renews it?
Where are tokens kept?
Who looks at the audit for the script's writes, and how often?
What happens if the script misbehaves (who switches it off)?

Copy the table into the plan of the integration (Planning an integration).

Switching it off

The installation-wide switch is [Services] Enabled in extension/expservices/settings/expservices.ini; when it is disabled, every service answers 403 (Remote services). Your administrator can also revoke one token, or disable the account a script uses (Offboarding staff). Know which of these you would use before you need it.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x