Actions

REST API

From LimeSurvey Manual

Revision as of 13:33, 18 October 2022 by Kfoster (talk | contribs)

TODO

Under development

Available from version x (LS 5.5.0?)

Available API endpoints

Technical specification. UML.

Introduction

LimeSurvey REST API v1 is available in LS 5.5.0 or more recent which offers various API endpoints.

Setup

Configure

In order to use REST API you must first enable the service, and then adjust the settings to suit your needs. To enable login to the LimeSurvey administration, go to Global settings, choose the tab 'Interfaces' and select 'Publish API on /rest'.

Security

The REST API uses the same security measures as the normal administration login. That means that the permission set of the used username and password is the same as if you would login in the administration with that user/password. Also the REST API is protected against brute-force password cracking - like the normal administration login.

Usage

API Location

The REST API URL is http://www.yourdomain.com/rest/v1 .

The available API endpoints are documented using swagger https://api.limesurvey.org/swagger.

Sessions

Endpoints

See the Swagger Documentation for full details.

/rest/v1/
session
session
siteSettings
siteSettings/<setting-name>
survey
survey/<id>
questionGroup/<surveyId>
questionGroup
questionGroup/<groupId>
questionGroupProperties/<groupId>
questioGroupProperties/<groupId>

Examples

PHP Example