Note: You are currently viewing documentation for Moodle 3.4. Up-to-date documentation for the latest stable version of Moodle is likely available here: Web services.

Web services: Difference between revisions

From MoodleDocs
No edit summary
m (link edit)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Managing a Moodle site}}
{{Managing a Moodle site}}
Web services enable other systems to login to Moodle and perform operations.  
Web services enable other systems to login to Moodle and perform operations.  
=== How it works ===
This simple example will give you an idea of how our web services infrastructure works.
#The client sends a username and password to the web service login script.
#The script returns a token for that user account.
#The client calls a particular web service function on a protocol server including the token .
#The protocol server uses the token to check that the web service session is still active.
#The protocol server call the matching external function, located in a externallib.php file inside the relevant module.
#The external function checks that the current user has_capability to do this operation.
#The external function calls the matching Moodle core function (in lib.php usually).
#The core function can return a result to the external function.
#The external function will return a result to the protocol server.
#The protocol server returns the result to the client.


== Administrator documentation ==
== Administrator documentation ==
Line 22: Line 9:
Most of the time, the client application will retrieve the key (token) for a user. However, it is still possible for a user to view the key and to regenerate it.
Most of the time, the client application will retrieve the key (token) for a user. However, it is still possible for a user to view the key and to regenerate it.
* [[Security keys|How to obtain a security key (token)]]
* [[Security keys|How to obtain a security key (token)]]
== Developer documentation==
The full API can be founnd on any Moodle sites under ''' Administration block > Plugins > Web services > API Documentation'''.
* [[Development:Creating a web service and a web service function | Implement a web service and a web service function]]
* [[Development:Creating a web service client | Implement a web service client]]
* [https://docs.moodle.org/dev/Web_services_Roadmap Web service Roadmap]


==See also==
==See also==
Sharing knowledge:
Sharing knowledge:
* The official discussion [http://moodle.org/mod/forum/view.php?id=6971| forum is here]
* [http://moodle.org/mod/forum/view.php?id=6971 Web services forum] on moodle.org
* [[Web_services_FAQ|Web services FAQ]]
* [[Web_services_FAQ|Web services FAQ]]


Specification / core development:
Developer documentation:
* [[Development:External services security]]
* [[Development:Web_services | Web services developer documentation]]
* [[Development:External services description]]
* [[:dev:Web_services_Roadmap | Web service Roadmap]]


Other implementations:
Other implementations:
Line 44: Line 24:
[[Category:Web Services]]
[[Category:Web Services]]


[[es:Servicios web]]
[[eu:Web-zerbitzuak]]
[[eu:Web-zerbitzuak]]
[[ja:ウェブサービス]]
[[ja:ウェブサービス]]

Latest revision as of 09:37, 26 January 2017

Web services enable other systems to login to Moodle and perform operations.

Administrator documentation

User documentation

Most of the time, the client application will retrieve the key (token) for a user. However, it is still possible for a user to view the key and to regenerate it.

See also

Sharing knowledge:

Developer documentation:

Other implementations: