Added docs

2019-01-27 15:16:58 +01:00
parent e9ef587821
commit 79305fb5bb
2 changed files with 109 additions and 0 deletions
--- a/docs/blackboard.txt
+++ b/docs/blackboard.txt
@@ -0,0 +1,89 @@
+## Used cookies
+
+s_session_id
+session_id
+
+## Get user profile and ID
+
+https://lms.fu-berlin.de/learn/api/v1/users/?userName=seedorf96
+https://lms.fu-berlin.de/learn/api/v1/users/_203980_1
+
+## Course list
+
+https://lms.fu-berlin.de/learn/api/public/v1/users/_203980_1/courses
+
+## Course details
+
+https://lms.fu-berlin.de/learn/api/v1/courses/_122802_1
+
+The field "courseId" in Blackboard can be matched to "props/kvv_lvnumbers" in "http://kvv.imp.fu-berlin.de/direct/site/<SITE_ID>"
+
+ - details
+     + semester
+         * type: parse "courseId"
+         * year: parse "courseId"
+     + lvNumber
+         * parse "courseId"
+     + title
+         * "displayName"
+     + lecturer
+         * https://lms.fu-berlin.de/learn/api/public/v1/courses/_127131_1/users
+         * Find Instructor
+         * Resolve "userId" to name
+     + type
+         * parse "courseId" ('Vorlesung'/'Seminar'/...?)
+     + description
+         * description
+     + ID
+         * id
+
+## Course annoncements
+
+https://lms.fu-berlin.de/learn/api/v1/courses/_127131_1/announcements?limit=1000&offset=0
+
+ - catch 400 (tool is not available)
+ - details
+     + id
+         * "id"
+     + title
+         * "title"
+     + body
+         * "body/rawText"
+     + createdBy
+         * "creatorUserId"
+         * search user name by id
+     + createdOn
+         * "startDateRestriction"
+     + urls
+         * not available / empty
+
+## Course resources
+
+https://lms.fu-berlin.de/learn/api/public/v1/courses/_127131_1/contents
+
+ - details
+     + author
+         * folder: N/A
+         * file: N/A
+     + modifiedDate
+         * folder: "created"
+         * file: "created"
+     + title
+         * folder: "title"
+         * file: "title"
+     + url
+         * folder: N/A
+         * file: N/A
+     + visible
+         * folder: "availability/available"
+         * file: "availability/available"
+     + container
+         * folder: "folder" ? same as kvv
+         * file: "file" ? same as kvv
+ - Folder "resource/x-bb-folder"
+     + https://lms.fu-berlin.de/learn/api/public/v1/courses/_127131_1/contents/_3602247_1/children
+ - File "resource/x-bb-document"
+     + https://lms.fu-berlin.de/learn/api/public/v1/courses/_127131_1/contents/_3635282_1/attachments
+     + text: "body"
+ - Attachment-Download
+     + https://lms.fu-berlin.de/learn/api/public/v1/courses/_127131_1/contents/_3635282_1/attachments/_2838023_1/download
--- a/docs/kvvlogin_new.txt
+++ b/docs/kvvlogin_new.txt
@@ -0,0 +1,20 @@
+ 1= GET https://kvv.imp.fu-berlin.de/Shibboleth.sso/Login?entityID=https://identity.fu-berlin.de/idp-fub-qa
+    -> Location-Header: https://identity.fu-berlin.de:9443/idp-fub-qa/profile/SAML2/Redirect/SSO?SAMLResponse=[SAMLResponse]&RelayState=[RelayState]
+ 2= GET [Location-Header 1]
+    -> Set-Cookie: JSESSIONID=[JSESSION-FU]
+    -> Location: /idp-fub-qa/profile/SAML2/Redirect/SSO?execution=e1s1
+ 3= GET [Location-Header 2]
+    + Cookie: JSESSIONID=[JSESSION-FU]
+ 4= POST [Location-Header 2]
+    + Body: j_username=[USERNAME]&j_password=[PASSWORD]&_eventId_proceed=
+    + Header: Content-Type: application/x-www-form-urlencoded
+    + Cookie: JSESSIONID=[JSESSION-FU]
+    -> Set-Cookie: shib_idp_session=[SHIB-IDP-SESSION]
+    -> Body SAMLResponse-Input-value
+ 5= POST https://kvv.imp.fu-berlin.de/Shibboleth.sso/SAML2/POST
+    + Body: SAMLResponse=[SAML-RESPONSE]
+    + Header: Content-Type: application/x-www-form-urlencoded
+    -> Set-Cookie: _shibsession_[SESS-NR]: [SESS-VALUE]
+ 6= https://kvv.imp.fu-berlin.de/sakai-login-tool/container
+    + Cookie: _shibsession_[SESS-NR]: [SESS-VALUE]
+    -> Set-Cookie: JSESSIONID: [JSESSION-KVV]