v1.0.1
© 2013 Advanced Distributed Learning Initiative, U.S. Department of Defense (Last updated 2013-0) i
„
1.0 Revision History of the Specification .................................................................................................................... 1
2.0 Role of the Experience API .................................................................................................................................. 3
2.1 ADL‟s Role in the Experience API ................................................................................................................. 3
2.2 Contributors ................................................................................................................................................... 3
2.1.1 Working Group Participants ................................................................................................................. 4
2.1.2 Requirements Gathering Participants .................................................................................................. 5
2.3 Reading Guidelines for the non-technically inclined ..................................................................................... 5
3.0 Definitions ............................................................................................................................................................ 6
4.0 Statement ............................................................................................................................................................. 8
4.1 Statement Properties ..................................................................................................................................... 8
4.1.1 ID ........................................................................................................................................................ 10
4.1.2 Actor ................................................................................................................................................... 10
4.1.3 Verb .................................................................................................................................................... 14
4.1 4 Object ................................................................................................................................................. 16
4.1.5 Result ................................................................................................................................................. 22
4.1.6 Context ............................................................................................................................................... 23
4.1.7 Timestamp ......................................................................................................................................... 26
4.1.8 Stored ................................................................................................................................................. 26
4.1.9 Authority ............................................................................................................................................. 27
4.1 10 Version ............................................................................................................................................. 28
4.1.11 Attachments ..................................................................................................................................... 29
4.1.12 Data Constraints .............................................................................................................................. 32
4.2 Retrieval of Statements ............................................................................................................................... 33
4.3 Voided .......................................................................................................................................................... 34
4.4 Signed Statements ...................................................................................................................................... 35
5.0 Miscellaneous Types .......................................................................................................................................... 36
5.1 Document .................................................................................................................................................... 36
5.2 Language Map ............................................................................................................................................. 36
5.3 Extensions ................................................................................................................................................... 37
5.4 Identifier Metadata ....................................................................................................................................... 38
6.0 Runtime Communication .................................................................................................................................... 39
6.1 Encoding ...................................................................................................................................................... 39
6.2 API Versioning ............................................................................................................................................. 40
6.3 Concurrency ................................................................................................................................................ 41
6.4 Security ........................................................................................................................................................ 42
6.4.1 Process of Each Scenario .................................................................................................................. 43
6.4.2 OAuth Authorization Scope ................................................................................................................ 44
7.0 Data Transfer (REST) ........................................................................................................................................ 46
7.1 Error Codes ................................................................................................................................................. 47
7.2 Statement API.............................................................................................................................................. 48
7.2.1 PUT Statements ................................................................................................................................. 48