This document provides an overview of the Valence API basics, including what the Valence API is, how to set it up, and how to use it. The Valence API is a REST API that allows communication with the Desire2Learn learning platform via HTTP requests using standard methods like GET, POST, PUT, and DELETE. To set up the API, developers must request API keys using the Keytool and ensure the correct roles and permissions are enabled. Once set up, developers can use SDKs and make HTTP requests to send data to and receive JSON responses from Desire2Learn.

1. VALENCE API BASICS
Glenn Watt
May 2, 2013

2. WHAT WILLTHIS SESSION COVER?
• What is theValence API
• How do you setupValance API
• How do you use it?
• What gets sent to D2L
• What gets returned from D2L

3. WHAT ISVALENCE API?

4. REST API
• REST Representational StateTransfer
• Client Server Architecture
• Stateless
• Cacheable
• Layered System
• Code On Demand (Not Supported)
• Uniform Interface

5. REST API
• GET
• POST
• PUT
• DELETE

6. OATH
• Open Standard for Authentication
D2LYour APP
Image courtesy Wikipedia.org
User
. .
<

7. HOW DOYOU SETUPVALENCE

8. API ID AND KEY
• Must have a Google Account
• Make a key request to D2L using KEYTOOL

9. KEYTOOL
http://keytool.valence.desire2learn.com/extensionmanagement/ui/
AppDeveloperKeys.php

10. KEYTOOL

11. KEYTOOL

12. KEYTOOL

13. KEYTOOL

14. D2L ENABLE API

15. ROLES AND PERMISSIONS

16. MANAGE EXTENSIBILITY

17. EXTENSIBILITY MANAGEMENT

18. HOW DOYOU USE IT?

19. SDK
http://docs.valence.desire2learn.com/clients/index.html

20. DOWNLOAD
Demo

26. SENDTO D2L

27. API REFERENCE

28. API REFERENCE
/d2l/api/lp/1.0/users/&userid=wattg

29. RECEIVE FROM D2L

30. JSON

31. JSON

32. VALENCE API REFERENCE
• http://docs.valence.desire2learn.com/reference.html

33. THIS SESSION COVERED
• What is theValence API
• How do you setupValance API
• How do you useValence?
• What gets sent to D2L
• What gets returned from D2L

34. RESOURCES
• Valence documentation home page: http://desire2learn.com/r/valencehome/
• Key Request Instructions http://docs.valence.desire2learn.com/clients/tools/keytool.html
• SDK http://docs.valence.desire2learn.com/clients/index.html
• GlennWatt@Me.Com

35. VALENCE API BASICS
Glenn Watt
May 2, 2013