wisemapping-open-source/wise-webapp/doc/REST Services.md

43 lines
2.0 KiB
Markdown
Raw Normal View History

2012-09-08 17:01:26 +02:00
REST Services
---------------
2012-11-02 01:36:41 +01:00
Introduction
-------------
All WiseMapping services are exposed as REST services. Those services are the same used by the WiseMapping when you are using it.
In the following section, all supported services are listed.
REST Console
-------------
You can learn how what are WiseMapping REST API's from using our interactive console. You can access it from here: http://localhost:8080/doc/rest/index.html.
Important: Don't forget to configure your server host url in /WEB-INF/app.properties. By default it's configure to http://localhost:8080/wisemapping/</p>
CURL Usage Examples
-------------
The following variables should be replaced:
2012-11-02 01:36:41 +01:00
- host.name: Host name where WiseMapping is deployed. Default Value: localhost
- host.post: Post number where WiseMapping is deployed. Default Value: 8080
- context.path: Context Path name where the application is deployed. Default Value: wisemapping
2012-11-02 01:36:41 +01:00
Obtaining user information by email:
* Template Path: /service/admin/users/email/{user.email}.json
* Example: curl "http://{host.name}:{host.port}/{context.path}/service/admin/users/email/{user.email}.json" --GET --basic -u "admin@wisemapping.org:test"
2012-09-08 17:01:26 +02:00
Deleting a based on the user id:
2012-11-02 01:36:41 +01:00
* Template Path: /service/admin/users/{userId}
* curl "http://{host.name}:{host.port}/{context.path}/service/admin/users/{userId}" --request DELETE --basic -u "admin@wisemapping.org:test"
2012-09-08 17:01:26 +02:00
Changing Password:
Template Path: /service/admin/users/{userId}/password
* curl "http://{host.name}:{host.port}/{context.path}/service/admin/users/{userId}/password" --request PUT --basic -u "admin@wisemapping.org:test" -H "Content-Type:text/plain" --data "<new_password>"
2013-02-23 00:08:48 +01:00
Creating a new user:
* Template Path: /service/admin/users/
* Method: Post
2023-07-31 03:21:25 +02:00
* curl "http://{host.name}:{host.port}/{context.path}/service/admin/users/" --request POST --basic -u "admin@wisemapping.org:test" -H "Content-Type:application/json" --data '{"email": "te2@mydomain.de", "lastname": "lastname", "firstname":"myfirstname","password":"password"}'