elisaado/somtoday-api-docs
GitHub: elisaado/somtoday-api-docs
SOMtoday 教育管理系统的 REST API 接口文档，涵盖学生数据、成绩、日程、考勤、作业等功能。
Stars: 86 | Forks: 18
# SOMtoday REST API 文档
#### 社区
##### Matrix（桥接至 Discord）
[](https://matrix.to/#/#somtoday:elisaado.com)
##### Discord（桥接至 Matrix）
[](https://discord.gg/yE3e3erCut)
## 目录
- [SOMtoday REST API 文档](#somtoday-rest-api-docs)
- [Discord](#discord)
- [目录](#table-of-contents)
- [一些杂项](#some-miscellaneous-stuff)
- [认证/授权](Authentication.md)
- [获取学校列表](Authentication.md#getting-a-list-of-schools)
- [通过模拟 SOMToday 应用/网页进行认证](Authentication.md#authentication-by-mimicking-the-somtoday-appwebapp)
- [通过 SSO 获取访问令牌](Authentication.md#authentication-using-sso-single-sign-on)
- [通过 Somtoday 登录获取访问令牌：`POST /oauth2/token`](Authentication.md#fetching-the-access-token-via-somtoday-login)
- [刷新令牌：`POST /oauth2/token`](Authentication.md#refreshing-the-access-token)
- [获取信息](#fetching-information)
- [当前学生：`GET /rest/v1/leerlingen`](#current-students-get-restv1leerlingen)
- [按 ID 查询学生：`GET /rest/v1/leerlingen/[id]`](#按-id-查询学生-get-restv1leerlingenid)
- [成绩：`GET /rest/v1/resultaten/huidigVoorLeerling/[id]`](#成绩-get-restv1resultatenhuidigvoorleerlingid)
- [日程：`GET /rest/v1/afspraken`](#schedule-get-restv1afspraken)
- [缺勤报告：`GET /rest/v1/absentiemeldingen`](#absence-reports-get-restv1absentiemeldingen)
- [学习指南：`GET /rest/v1/studiewijzers`](#study-guides-get-restv1studiewijzers)
- [科目：`GET /rest/v1/vakken`](#subjects-get-restv1vakken)
- [用户账户：`GET /rest/v1/account`](#account-get-restv1account--get-restv1accountid)
- [学年：`GET /rest/v1/schooljaren`](#schooljaren-get-restv1schooljaren--get-restv1schooljarenid)
- [选课：`GET /rest/v1/vakkeuzes`](#vakkeuzes-get-restv1vakkeuzes)
- [考勤记录：`GET /rest/v1/waarnemingen`](#waarnemingen-get-restv1waarnemingen)
- [消息：`GET /rest/v1/boodschappen/conversaties`](#messages-get-restv1boodschappenconversaties)
- [学校信息：`GET /rest/v1/leerlingen/[id]/schoolgegevens`](#学校信息-get-restv1idschoolgegevens)
- [假期：`GET /rest/v1/vakanties/leerling/[id]`](#假期-get-restv1vakantiesleerlingid)
- [学习资料：`GET /rest/v1/vakken/studiemateriaal/[id]` & `GET rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` & `/rest/v1/studiemateriaal/algemeen/[id]`](#学习资料-get-restv1vakkenstudiemateriaalid--get-restv1vakkenstudiemateriaalidvakuuid--restv1studiemateriaalalgemeenid)
- [ICalendar：`GET /rest/v1/icalendar`](#icalendar-get-restv1icalendar)
- [ICalendar：`DELETE /rest/v1/icalendar`](#icalendar-delete-restv1icalendar)
- [作业](Homework.md)
- [1. 来自日程的作业：`GET /rest/v1/studiewijzeritemafspraaktoekenningen`](Homework.md#1-homework-from-appointments-get-restv1studiewijzeritemafspraaktoekenningen)
- [2. 来自天数的作业：`GET /rest/v1/studiewijzeritemdagtoekenningen`](Homework.md#2-homework-from-days-get-restv1studiewijzeritemdagtoekenningen)
- [3. 来自周数的作业：`GET /rest/v1/studiewijzeritemweektoekenningen`](Homework.md#3-homework-from-weeks-get-restv1studiewijzeritemweektoekenningen)
- [1. 已完成作业 `PUT /rest/v1/swigemaakt/[id]`](Homework.md#1-homework-made-put-restv1swigemaaktid) - [2. 已完成作业 `PUT /rest/v1/swigemaakt/cou`](Homework.md#2-homework-made-put-restv1swigemaaktcou) ## 一些杂项
- 你可以使用 curl 进行示例请求，例如： ``` curl http://example.com/user/blah?active=true&limit=3 -d "key=value&otherkey=value" -H "AHeader: Value" ``` 这将在这里列出为 | 名称 | 类型 | 值 | |----------|--------|-------| | id | URL | blah | | active | 查询 | true | | limit | 查询 | 3 | | key | 请求体 | value | | otherkey | 请求体 | value | | AHeader | Header | Value | 当有值是您特有的（如用户名、密码或令牌）时，它会有类似 `[username]` 的值。 我不建议在您的编程语言中使用 curl，PHP 除外，但即使在 PHP 中也很麻烦。有更好的库可以使用。
NodeJS：[node-fetch](https://github.com/bitinn/node-fetch)、[HTTP from stdlib](https://nodejs.org/api/http.html)、[Request](https://github.com/request/request)、[Axios](https://github.com/axios/axios)
Go：[net/http](https://golang.org/pkg/net/http/)
Ruby：[Faraday](https://github.com/lostisland/faraday)、[HTTParty](https://github.com/jnunemaker/httparty)
Python：[requests](http://docs.python-requests.org/en/master/)
如果您知道更多，请添加更多。
## 获取信息
baseurl：获取令牌时返回（`somtoday_api_url`），通常是 api.somtoday.nl。
此处所有路由都以此 baseurl 为前缀。
### 当前学生：`GET /rest/v1/leerlingen`
"
}
},
"leerlingnummer": 450000,
"roepnaam": "Eli",
"achternaam": "Saado",
"email": "450000@live.bc-enschede.nl",
"mobielNummer": "06-00000000",
"geboortedatum": "2000-00-00",
"geslacht": "Man"
}
]
}
```
#### 示例
```
token='' school_url=https://api.somtoday.nl
curl "$school_url/rest/v1/leerlingen" -H "Authorization: Bearer $token" -H "Accept: application/json"
```
### 按 ID 查询学生：`GET /rest/v1/leerlingen/[id]`
#### 参数
| 名称 | 类型 | 值 |
|---------------|--------|-----------------------|
| id | URL | [user id] |
| Authorization | Header | Bearer [access_token] |
#### 返回
```
{
"links": [
{
"id": 1234,
"rel": "self",
"type": "leerling.RLeerling",
"href": "https://api.somtoday.nl/rest/v1/leerlingen/1234"
}
],
"permissions": [
{
"full": "leerling.RLeerlingPrimer:READ:INSTANCE(1234)",
"type": "leerling.RLeerlingPrimer",
"operations": ["READ"],
"instances": ["INSTANCE(1234)"]
}
],
"additionalObjects": {},
"leerlingnummer": 450000,
"roepnaam": "Eli",
"achternaam": "Saado",
"email": "450000@live.bc-enschede.nl",
"mobielNummer": "06-00000000",
"geboortedatum": "2000-00-00",
"geslacht": "Man"
}
```
#### 示例
```
token='' school_url=https://api.somtoday.nl id=1234
curl "$school_url/rest/v1/leerlingen/$id" -H "Authorization: Bearer $token" -H "Accept: application/json"
```
### 成绩：`GET /rest/v1/resultaten/huidigVoorLeerling/[id]`
)",
"type": "resultaten.RResultaat",
"operations": [
"READ"
],
"instances": [
"INSTANCE()"
]
}
],
"additionalObjects": {},
"herkansingstype": "Geen",
"resultaat": "7.9",
"geldendResultaat": "7.9",
"datumInvoer": "2019-09-10T13:41:11.805+02:00",
"teltNietmee": false,
"toetsNietGemaakt": false,
"leerjaar": 0,
"periode": 0,
"examenWeging": 0,
"isExamendossierResultaat": true,
"isVoortgangsdossierResultaat": false,
"type": "ToetssoortGemiddeldeKolom",
"vak": {
"links": [
{
"id": 1234,
"rel": "self",
"type": "onderwijsinrichting.RVak",
"href": "https://api.somtoday.nl/rest/v1/vakken/1234"
}
],
"permissions": [
{
"full": "onderwijsinrichting.RVak:READ:INSTANCE()",
"type": "onderwijsinrichting.RVak",
"operations": [
"READ"
],
"instances": [
"INSTANCE()"
]
}
],
"additionalObjects": {},
"afkorting": "ckv",
"naam": "culturele en kunstzinnige vorming"
},
"leerling": {
"links": [
{
"id": 1234,
"rel": "self",
"type": "leerling.RLeerlingPrimer",
"href": "https://api.somtoday.nl/rest/v1/leerlingen/1234"
}
],
"permissions": [
{
"full": "leerling.RLeerlingPrimer:READ:INSTANCE()",
"type": "leerling.RLeerlingPrimer",
"operations": [
"READ"
],
"instances": [
"INSTANCE()"
]
}
],
"additionalObjects": {},
"UUID": "070dabd4-3449-4af3-8c38-788faac283a3",
"leerlingnummer": 1234,
"roepnaam": "",
"voorvoegsel": "",
"achternaam": ""
}
},
...
}
```
### 日程：`GET /rest/v1/afspraken`
### 缺勤报告：`GET /rest/v1/absentiemeldingen`
### 学习指南：`GET /rest/v1/studiewijzers`
### 科目：`GET /rest/v1/vakken`
",
"naam": ""
}
...
]
}
```
### 账户：`GET /rest/v1/account/` / `GET /rest/v1/account/[id]` / `GET /rest/v1/account/me`
### 学年：`GET /rest/v1/schooljaren` / `GET /rest/v1/schooljaren/[id]`
### 选课：`GET /rest/v1/vakkeuzes`
### 考勤记录：`GET /rest/v1/waarnemingen`
### 消息：`GET /rest/v1/boodschappen/conversaties`
### 学校信息：`GET /rest/v1/leerlingen/[id]/schoolgegevens`
### 假期：`GET /rest/v1/vakanties/leerling/[id]`
### 学习资料：`GET /rest/v1/vakken/studiemateriaal/[id]` & `GET rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` & `/rest/v1/studiemateriaal/algemeen/[id]`
### ICalendar：`GET /rest/v1/icalendar`
### ICalendar：`DELETE /rest/v1/icalendar`
### 未文档化：
- `GET /rest/v1/medewerkers/ontvangers`
- `GET /rest/v1/maatregeltoekenningen`
- `GET /rest/v1/leerlingadresseringen`
- `GET /rest/v1/verzorgers/`
- `GET /rest/v1/onderwijsopafstandperiodes/`
- `GET /rest/v1/edurouteportaluserproduct/[id]`
- `GET /rest/v1/methodeinformatie/[id]`
- [1. 已完成作业 `PUT /rest/v1/swigemaakt/[id]`](Homework.md#1-homework-made-put-restv1swigemaaktid) - [2. 已完成作业 `PUT /rest/v1/swigemaakt/cou`](Homework.md#2-homework-made-put-restv1swigemaaktcou) ## 一些杂项
点击打开杂项
- API 端点在获取访问令牌时返回 - 始终包含 header "Accept"，值为 "application/json"，这样你就不会收到 XML。（除非你想要 XML :-) ）（认证相关的内容始终返回 JSON）- 你可以使用 curl 进行示例请求，例如： ``` curl http://example.com/user/blah?active=true&limit=3 -d "key=value&otherkey=value" -H "AHeader: Value" ``` 这将在这里列出为 | 名称 | 类型 | 值 | |----------|--------|-------| | id | URL | blah | | active | 查询 | true | | limit | 查询 | 3 | | key | 请求体 | value | | otherkey | 请求体 | value | | AHeader | Header | Value | 当有值是您特有的（如用户名、密码或令牌）时，它会有类似 `[username]` 的值。 我不建议在您的编程语言中使用 curl，PHP 除外，但即使在 PHP 中也很麻烦。有更好的库可以使用。
您语言对应的库列表
JavaScript：[window.fetch](https://developers.google.com/web/updates/2015/03/introduction-to-fetch)NodeJS：[node-fetch](https://github.com/bitinn/node-fetch)、[HTTP from stdlib](https://nodejs.org/api/http.html)、[Request](https://github.com/request/request)、[Axios](https://github.com/axios/axios)
Go：[net/http](https://golang.org/pkg/net/http/)
Ruby：[Faraday](https://github.com/lostisland/faraday)、[HTTParty](https://github.com/jnunemaker/httparty)
Python：[requests](http://docs.python-requests.org/en/master/)
如果您知道更多，请添加更多。
点击打开
此 REST 方法可能会返回多个学生（我无法测试），因为它使用 /leerlingen（荷兰语中学生的复数形式）。 我猜想它会返回当前用户有权访问的所有学生（因此如果学校管理员运行它，将返回学校中的所有学生）。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | additional | 参数 | pasfoto | additional 参数是一个可选的 GET 参数。 #### 返回 根据 additional 参数的不同，结果中的某些项目可能不存在。假设设置了 `pasfoto`： ``` { "items": [ { "$type": "leerling.RLeerling", "links": [ { "id": 1234, "rel": "self", "type": "leerling.RLeerling", "href": "https://api.somtoday.nl/rest/v1/leerlingen/1234" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(1234)", "type": "leerling.RLeerlingPrimer", "operations": ["READ"], "instances": ["INSTANCE(1234)"] } ], "additionalObjects": { "pasfoto": { "$type": "leerling.RLeerlingpasfoto", "links": [ { "id": 1234, "rel": "self" } ], "permissions": [], "additionalObjects": {}, "datauri": "点击打开
获取学生的成绩。请注意，所有平均成绩也是 API 返回的成绩项目。不同的列类型由 json 中的 `type` 属性表示（例如 'Toetskolom'、'ToetssoortGemiddeldeKolom'）。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|------------------------------| | id | URL | [user id] | | Authorization | Header | Bearer [access_token] | | Range | Header | items=[LowerBound]-[UpperBound] | | additional | 参数 | berekendRapportCijfer | | additional | 参数 | samengesteldeToetskolomId | | additional | 参数 | resultaatkolomId | | additional | 参数 | cijferkolomId | | additional | 参数 | toetssoortnaam | | additional | 参数 | huidigeAnderVakKolommen | 这些 LowerBound 和 UpperBound 值是您想要请求的成绩数量（API 在此处使用分页）。该值不能超过 100，因此获取**所有**成绩的方法如下： 1. 请求 0-99 . 请求 100-199 3. 请求 200-299 4. 请求 .00-.99 5. 继续直到响应包含少于 99 条记录 6. 完成！ #### 返回 ``` { "items": [ { "$type": "resultaten.RResultaat", "links": [ { "id": 1234, "rel": "self", "type": "resultaten.RResultaat", "href": "https://api.somtoday.nl/rest/v1/resultaten/1234" } ], "permissions": [ { "full": "resultaten.RResultaat:READ:INSTANCE(点击打开
获取学生的日程预约。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | sort | 参数 | asc-id | | additional | 参数 | vak | | additional | 参数 | docentAfkortingen | | additional | 参数 | leerlingen | | begindatum | 参数 | yyyy-MM-dd | | einddatum | 参数 | yyyy-MM-dd | #### 返回 ``` { "items": [ { "$type": "participatie.RAfspraak", "links": [ { "id": 8849104409, "rel": "self", "type": "participatie.RAfspraak", "href": "AFSPRAAK_URL" } ], "permissions": [ { "full": "participatie.RAfspraak:READ:INSTANCE(8849104409)", "type": "participatie.RAfspraak", "operations": ["READ"], "instances": ["INSTANCE(8849104409)"] } ], "additionalObjects": { "vak": { "$type": "onderwijsinrichting.RVak", "links": [ { "id": 126211284, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "VAK_URL" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(126211284)", "type": "onderwijsinrichting.RVak", "operations": ["READ"], "instances": ["INSTANCE(126211284)"] } ], "additionalObjects": {}, "afkorting": "wisB", "naam": "wiskunde B" }, "docentAfkortingen": "Stk", "leerlingen": { "$type": "LinkableWrapper", "items": [ { "$type": "leerling.RLeerlingPrimer", "links": [ { "id": 546308480, "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "LEERLING_URL" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(546308480)", "type": "leerling.RLeerlingPrimer", "operations": ["READ"], "instances": ["INSTANCE(546308480)"] } ], "additionalObjects": {}, "UUID": "UUID", "leerlingnummer": 119371, "roepnaam": "Christos", "achternaam": "Karapasias" } ] } }, "afspraakType": { "links": [ { "id": 144662674, "rel": "self", "type": "participatie.RAfspraakType", "href": "AFSPRAAK_TYPE_URL" } ], "permissions": [ { "full": "participatie.RAfspraakType:READ:INSTANCE(144662674)", "type": "participatie.RAfspraakType", "operations": ["READ"], "instances": ["INSTANCE(144662674)"] } ], "additionalObjects": {}, "naam": "Les", "omschrijving": "Les", "standaardKleur": -2394583, "categorie": "Rooster", "activiteit": "Verplicht", "percentageIIVO": 0, "presentieRegistratieDefault": true, "actief": true, "vestiging": { "$type": "instelling.RVestiging", "links": [ { "id": 126208855, "rel": "self", "type": "instelling.RVestiging", "href": "VESTIGING_URL" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(126208855)", "type": "instelling.RVestiging", "operations": ["READ"], "instances": ["INSTANCE(126208855)"] } ], "additionalObjects": {}, "naam": "Fortes Lyceum" } }, "locatie": "217", "beginDatumTijd": "2020-05-04T11:15:00.000+02:00", "eindDatumTijd": "2020-05-04T12:00:00.000+02:00", "beginLesuur": 4, "eindLesuur": 4, "titel": "217 - A5wisB_2 - Stk", "omschrijving": "217 - A5wisB_2 - Stk", "presentieRegistratieVerplicht": true, "presentieRegistratieVerwerkt": false, "afspraakStatus": "ACTIEF", "vestiging": { "links": [ { "id": 126208855, "rel": "self", "type": "instelling.RVestiging", "href": "VESTIGING_URL" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(126208855)", "type": "instelling.RVestiging", "operations": ["READ"], "instances": ["INSTANCE(126208855)"] } ], "additionalObjects": {}, "naam": "SCHOOL_NAAM" } } ] } ``` #### 示例 ``` curl "$school_url/rest/v1/afspraken?sort=asc-id&additional=vak&additional=docentAfkortingen&additional=leerlingen&begindatum=2020-05-01&einddatum=2020-05-19" -H "Authorization: Bearer $token" -H "Accept: application/json" ```点击打开
获取用户的缺勤报告 #### 参数 | 名称 | 类型 | 值 | |----------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | begindatumtijd | 参数 | yyyy-MM-dd | | einddatumtijd | 参数 | yyyy-MM-dd | #### 返回 缺勤报告数组 ``` { "items": [ { "$type": "participatie.RAbsentieMelding", "links": [ { "id": 1234567890123, "rel": "self", "type": "participatie.RAbsentieMelding", "href": "{{api_url}}/rest/v1/waarnemingen/1234567890123" } ], "permissions": [], "additionalObjects": {}, "leerling": { "links": [ { "id": 1234567890, "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "{{api_url}}/rest/v1/leerlingen/1234567890" } ], "permissions": [], "additionalObjects": {}, "UUID": "12abc34e-12a3-1a2b-a1b2-1a2b34cd5e67", "leerlingnummer": 100000, "roepnaam": "Name", "achternaam": "Name" }, "absentieReden": { "links": [ { "id": 1234567890, "rel": "self", "type": "participatie.RAbsentieRedenPrimer", "href": "{{api_url}}/rest/v1/absentieredenen/1234567890" } ], "permissions": [], "additionalObjects": {}, "absentieSoort": "Absent", "afkorting": "XC", "omschrijving": "Onbekend", "geoorloofd": false }, "datumTijdInvoer": "yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm", "beginDatumTijd": "yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm", "eindDatumTijd": "yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm", "beginLesuur": 3, "eindLesuur": 3, "afgehandeld": true, "eigenaar": { "links": [ { "id": 1234567890, "rel": "self", "type": "medewerker.RMedewerker", "href": "{{api_url}}/rest/v1/medewerkers/1234567890" } ], "permissions": [], "additionalObjects": {}, "UUID": "12abc34e-12a3-1a2b-a1b2-1a2b34cd5e67", "nummer": 100000, "afkorting": "HH", "achternaam": "Henk", "geslacht": "MAN", "voorletters": "H.H.", "roepnaam": "Hans" } } ] } ```点击打开
获取用户的学习指南 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | additional | 参数 | leerlingen | | additional | 参数 | bijlagen | | additional | 参数 | externeMaterialen | | additional | 参数 | bijlageMappen | additional 参数是可选的 GET 参数，用于在结果中包含信息。`leerlingen` 在学生查询时只会返回 1 个结果，但在教师/学校管理员查询时会获取所有学生。 #### 返回 根据 additional 参数的不同，结果中的某些项目可能不存在。假设设置了所有 4 个： ``` { "items": [ { "$type": "studiewijzer.RStudiewijzer", "links": [ { "id": 3709468886305, "rel": "self", "type": "studiewijzer.RStudiewijzer", "href": "https://api.somtoday.nl/rest/v1/studiewijzers/3709468886305" } ], "permissions": [ { "full": "studiewijzer.RStudiewijzer:READ:INSTANCE(3709468886305)", "type": "studiewijzer.RStudiewijzer", "operations": [ "READ" ], "instances": [ "INSTANCE(3709468886305)" ] } ], "additionalObjects": { "bijlageMappen": { "$type": "LinkableWrapper", "items": [] }, "bijlagen": { "$type": "LinkableWrapper", "items": [] }, "leerlingen": { "$type": "LinkableWrapper", "items": [ { "$type": "leerling.RLeerlingPrimer", "links": [ { "id": 9496745174, "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "https://api.somtoday.nl/rest/v1/leerlingen/9496745174" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(9496745174)", "type": "leerling.RLeerlingPrimer", "operations": [ "READ" ], "instances": [ "INSTANCE(9496745174)" ] } ], "additionalObjects": {}, "UUID": "f8cf6f6c-c213-4526-8ba1-6a306cf724a4", "leerlingnummer": 123456, "roepnaam": "{{first_name}}", "achternaam": "{{last_name}}" } ] }, "externeMaterialen": { "$type": "LinkableWrapper", "items": [] } }, "uuid": "4d2188a0-03d8-4dca-9f51-0e54d3c353c6", "naam": "vwo5.schka", "vestiging": { "links": [ { "id": 9496567717, "rel": "self", "type": "instelling.RVestiging", "href": "https://api.somtoday.nl/rest/v1/vestigingen/9496567717" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(9496567717)", "type": "instelling.RVestiging", "operations": [ "READ" ], "instances": [ "INSTANCE(9496567717)" ] } ], "additionalObjects": {}, "naam": "Stella Maris College Meerssen" }, "lesgroep": { "links": [ { "id": 3543707887108, "rel": "self", "type": "lesgroep.RLesgroep", "href": "https://api.somtoday.nl/rest/v1/lesgroepen/3543707887108" } ], "permissions": [ { "full": "lesgroep.RLesgroep:READ:INSTANCE(3543707887108)", "type": "lesgroep.RLesgroep", "operations": [ "READ" ], "instances": [ "INSTANCE(3543707887108)" ] } ], "additionalObjects": {}, "UUID": "d4afb5b8-fbf6-4bbd-ac73-cb50cc883392", "naam": "vwo5.schka", "schooljaar": { "$type": "onderwijsinrichting.RSchooljaar", "links": [ { "id": 40851957, "rel": "self", "type": "onderwijsinrichting.RSchooljaar", "href": "https://api.somtoday.nl/rest/v1/schooljaren/40851957" } ], "permissions": [ { "full": "onderwijsinrichting.RSchooljaar:READ:INSTANCE(40851957)", "type": "onderwijsinrichting.RSchooljaar", "operations": [ "READ" ], "instances": [ "INSTANCE(40851957)" ] } ], "additionalObjects": {}, "naam": "2021/2022", "vanafDatum": "2021-08-01", "totDatum": "2022-07-31", "isHuidig": true }, "vak": { "links": [ { "id": 9505018979, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "https://api.somtoday.nl/rest/v1/vakken/9505018979" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(9505018979)", "type": "onderwijsinrichting.RVak", "operations": [ "READ" ], "instances": [ "INSTANCE(9505018979)" ] } ], "additionalObjects": {}, "afkorting": "schk", "naam": "Scheikunde" }, "heeftStamgroep": false, "examendossierOndersteund": true, "vestiging": { "links": [ { "id": 9496567717, "rel": "self", "type": "instelling.RVestiging", "href": "https://api.somtoday.nl/rest/v1/vestigingen/9496567717" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(9496567717)", "type": "instelling.RVestiging", "operations": [ "READ" ], "instances": [ "INSTANCE(9496567717)" ] } ], "additionalObjects": {}, "naam": "Stella Maris College Meerssen" } } } ... ] } ```点击打开
获取用户的科目 #### 参数 | 名称 | 类型 | 值 | |---------------|--------|-----------------------| | Authorization | Header | Bearer [access_token] | #### 返回 ``` { "items": [ { "$type": "onderwijsinrichting.RVak", "links": [ { "id": 123456789, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "https://api.somtoday.nl/rest/v1/vakken/123456789" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(123456789)", "type": "onderwijsinrichting.RVak", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "afkorting": "点击打开
获取与 Somtoday 访问令牌关联的账户信息 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | id | URL | [user-id] | | Authorization | Header | Bearer [access_token] | | additional | 参数 | restricties | #### 返回 ``` { "items": [ { "$type": "auth.RAccount", "links": [ { "id": 1234567890, "rel": "self", "type": "auth.RAccount", "href": "https://api.somtoday.nl/rest/v1/account/1234567890" } ], "permissions": [ { "full": "auth.RAccount:READ:INSTANCE(1234567890)", "type": "auth.RAccount", "operations": [ "READ" ], "instances": [ "INSTANCE(1234567890)" ] } ], "additionalObjects": { "restricties": { "$type": "LinkableWrapper", "items": [ { "$type": "restricties.REloRestricties", "links": [], "permissions": [], "additionalObjects": {}, "vestigingsId": REDACTED, "leerlingId": REDACTED, "mobieleAppAan": true, "studiewijzerAan": true, "berichtenVerzendenAan": false, "leermiddelenAan": true, "adviezenTokenAan": true, "opmerkingRapportCijferTonenAan": true, "periodeGemiddeldeTonenResultaatAan": true, "rapportGemiddeldeTonenResultaatAan": true, "rapportCijferTonenResultaatAan": true, "toetssoortgemiddeldenAan": true, "seResultaatAan": true, "stamgroepLeerjaarAan": true, "emailWijzigenAan": false, "mobielWijzigenAan": false, "wachtwoordWijzigenAan": true, "absentiesBekijkenAan": true, "absentieConstateringBekijkenAan": true, "absentieMaatregelBekijkenAan": true, "absentieMeldingBekijkenAan": true, "berichtenBekijkenAan": true, "cijfersBekijkenAan": true, "huiswerkBekijkenAan": true, "nieuwsBekijkenAan": true, "pasfotoLeerlingTonenAan": true, "pasfotoMedewerkerTonenAan": false, "profielBekijkenAan": true, "roosterBekijkenAan": true, "roosterBeschikbaarIcalAan": true, "vakkenBekijkenAan": true, "lesurenVerbergenSettingAan": false } ] } }, "gebruikersnaam": "[REDACTED]", "accountPermissions": [], "persoon": { "$type": "leerling.RLeerlingPrimer", "links": [ { "id": "0123456789", "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "https://api.somtoday.nl/rest/v1/leerlingen/0123456789" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(1409824200)", "type": "leerling.RLeerlingPrimer", "operations": [ "READ" ], "instances": [ "INSTANCE(0123456789)" ] } ], "additionalObjects": {}, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "leerlingnummer": 100000, "roepnaam": "Name", "voorvoegsel": "Name", "achternaam": "Name" } } ] } ```点击打开
获取学年信息 #### 参数 | 名称 | 类型 | 值 | |---------------|--------|-----------------------| | id | URL | [id] | | id | URL | huidig | | Authorization | Header | Bearer [access_token] | 当您想获取当前学年的信息时，请在 URL 中添加 /huidig #### 返回 ``` { "items": [ { "$type": "onderwijsinrichting.RSchooljaar", "links": [ { "id": 40851958, //this id is for everyone the same (in this case for year 2022/2023) "rel": "self", "type": "onderwijsinrichting.RSchooljaar", "href": "https://api.somtoday.nl/rest/v1/schooljaren/40851958" } ], "permissions": [ { "full": "onderwijsinrichting.RSchooljaar:READ:INSTANCE(40851958)", "type": "onderwijsinrichting.RSchooljaar", "operations": [ "READ" ], "instances": [ "INSTANCE(40851958)" ] } ], "additionalObjects": {}, "naam": "2022/2023", "vanafDatum": "2022-08-01", "totDatum": "2023-07-31", "isHuidig": true }, ... ] } ```点击打开
获取您当前已报名的所有科目。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | additional | 参数 | vaknormering | | additional | 参数 | actiefOpPeildatum | #### 返回 ``` { "items": [ { "$type": "onderwijsinrichting.RVakkeuze", "links": [ { "id": xxxxxxxxxx, "rel": "self", "type": "onderwijsinrichting.RVakkeuze", "href": "https://api.somtoday.nl/rest/v1/vakkeuzes/xxxxxxxxxx" } ], "permissions": [ { "full": "onderwijsinrichting.RVakkeuze:READ:INSTANCE(xxxxxxxxxx)", "type": "onderwijsinrichting.RVakkeuze", "operations": [ "READ" ], "instances": [ "INSTANCE(xxxxxxxxxx)" ] } ], "additionalObjects": { "vaknormering": { "$type": "onderwijsinrichting.RVakNormering", "vakId": yyyyyyyyyy, "toetsnormering1": "Standaard", "toetsnormering2": "Alternatief" } }, "vak": { "links": [ { "id": yyyyyyyyyy, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "https://api.somtoday.nl/rest/v1/vakken/yyyyyyyyyy" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(yyyyyyyyyy)", "type": "onderwijsinrichting.RVak", "operations": [ "READ" ], "instances": [ "INSTANCE(yyyyyyyyyy)" ] } ], "additionalObjects": {}, "afkorting": "ne", "naam": "Nederlandse taal" } }, ... ] } ```点击打开
获取当前绑定到您账户的所有考勤记录，按日期、isGeoorloofd 和/或 waarnemingSoort 进行筛选。 #### 参数 | 名称 | 类型 | 值 | |----------------------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | | waarnemingSoort（可选） | 参数 | Afwezig/aanwezig | | isGeoorloofd（可选） | 参数 | true/false | 如果需要，您可以提供日期来筛选结果。如果不提供任何日期，它将返回所有结果。 您可以提供日期范围或单个日期。如果您提供单个日期，它将返回该日期的所有结果。如果您提供日期范围，它将返回该日期范围内的所有结果。 | 日期类型 | 类型 | 值 | |-----------------|-----------|-------------| | begintNaOfOp | 参数 | yyyy-MM-dd | | 或者 | | beginDatumTijd | 参数 | yyyy-MM-dd | | eindDatumTijd | 参数 | yyyy-MM-dd | #### 返回 ``` { "items": [ { "$type": "participatie.RWaarneming", "links": [ { "id": 1234567891234, "rel": "self", "type": "participatie.RWaarneming", "href": "https://api.somtoday.nl/rest/v1/waarnemingen/1234567891234" } ], "permissions": [ { "full": "participatie.RWaarneming:READ:INSTANCE(1234567891234)", "type": "participatie.RWaarneming", "operations": [ "READ" ], "instances": [ "INSTANCE(1234567891234)" ] } ], "additionalObjects": {}, "beginDatumTijd": "2023-01-09T11:05:00.000+01:00", "eindDatumTijd": "2023-01-09T11:55:00.000+01:00", "beginLesuur": 4, "eindLesuur": 4, "waarnemingSoort": "Aanwezig", "leerling": { "links": [ { "id": 1234567890, "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "https://api.somtoday.nl/rest/v1/leerlingen/1234567890" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(1234567890)", "type": "leerling.RLeerlingPrimer", "operations": [ "READ" ], "instances": [ "INSTANCE(1234567890)" ] } ], "additionalObjects": {}, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "leerlingnummer": 100000, "roepnaam": "Name", "voorvoegsel": "Name", "achternaam": "Name" }, "afspraak": { "links": [ { "id": 12345678901345, "rel": "self", "type": "participatie.RAfspraakPrimer", "href": "https://api.somtoday.nl/rest/v1/afspraken/12345678901345" } ], "permissions": [ { "full": "participatie.RAfspraak:READ:INSTANCE(12345678901345)", "type": "participatie.RAfspraak", "operations": [ "READ" ], "instances": [ "INSTANCE(12345678901345)" ] } ], "additionalObjects": {}, "afspraakType": { "links": [ { "id": 1234567890, "rel": "self", "type": "participatie.RAfspraakType", "href": "https://api.somtoday.nl/rest/v1/afspraaktype/1234567890" } ], "permissions": [ { "full": "participatie.RAfspraakType:READ:INSTANCE(1234567890)", "type": "participatie.RAfspraakType", "operations": [ "READ" ], "instances": [ "INSTANCE(1234567890)" ] } ], "additionalObjects": {}, "naam": "LES", "omschrijving": "LES", "standaardKleur": -16448251, "categorie": "Rooster", "activiteit": "Verplicht", "percentageIIVO": 100, "presentieRegistratieDefault": true, "actief": true, "vestiging": { "$type": "instelling.RVestiging", "links": [ { "id": 1234567890, "rel": "self", "type": "instelling.RVestiging", "href": "https://api.somtoday.nl/rest/v1/vestigingen/1234567890" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(1234567890)", "type": "instelling.RVestiging", "operations": [ "READ" ], "instances": [ "INSTANCE(1234567890)" ] } ], "additionalObjects": {}, "naam": "De super coole school", } }, "locatie": "lokaal naam", "beginDatumTijd": "2023-01-09T11:05:00.000+01:00", "eindDatumTijd": "2023-01-09T11:55:00.000+01:00", "beginLesuur": 4, "eindLesuur": 4, "titel": "titel" }, "afgehandeld": true, "invoerDatum": "2023-01-09T11:09:08.000+01:00", "laatstGewijzigdDatum": "2023-01-09T11:09:08.000+01:00", "herkomst": "Medewerker", "ingevoerdDoor": { "links": [ { "id": 1234567890123, "rel": "self", "type": "medewerker.RMedewerkerPrimer", "href": "https://api.somtoday.nl/rest/v1/medewerkers/1234567890123" } ], "permissions": [], "additionalObjects": {}, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "nummer": 12345678, "afkorting": "afkorting", "achternaam": "name", "geslacht": "VROUW/MAN", "voorletters": "voorletter(s)", "roepnaam": "roepnaam" }, "laatstGewijzigdDoor": { "links": [ { "id": 1234567890123, "rel": "self", "type": "medewerker.RMedewerkerPrimer", "href": "https://api.somtoday.nl/rest/v1/medewerkers/1234567890123" } ], "permissions": [], "additionalObjects": {}, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "nummer": 12345678, "afkorting": "afkorting", "achternaam": "name", "geslacht": "VROUW/MAN", "voorletters": "voorletter(s)", "roepnaam": "roepnaam" } }, ... ] } ```点击打开
获取您的 SomToday 消息/berichten。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|------------------------| | Authorization | Header | Bearer [access_token] | | additional | 参数 | verzondenDoorGebruiker | | additional | 参数 | verzenderCorrespondent | | additional | 参数 | aantalExtraOntvangers | | additional | 参数 | actiefVoorGebruiker | | alle | 参数 | true/false | #### 返回 ``` { "items":[ { "$type":"berichten.RBoodschapConversatie", "boodschappen":[ { "links":[ { "id":1234567890, "rel":"koppeling", "type":"berichten.RBoodschap" } ], "permissions":[], "additionalObjects":{ "aantalExtraOntvangers":0, "verzondenDoorGebruiker":false, "ontvangerCorrespondenten":{ "$type":"NonLinkableWrapper", "items":[ { "$type":"berichten.RBoodschapCorrespondent", "naam":"REDACTED", "vakken":[] }, { "$type":"berichten.RBoodschapCorrespondent", "naam":"REDACTED", "vakken":[] } ] }, "verzenderCorrespondent":{ "$type":"berichten.RBoodschapCorrespondent", "naam":"REDACTED", "sorteerNaam":"REDACTED", "initialen":"REDACTED", "vakken":[ { "links":[ { "id":1234567890, "rel":"self", "type":"onderwijsinrichting.RVak", "href":"https://api.somtoday.nl/rest/v1/vakken/1234567890" } ], "permissions":[ { "full":"onderwijsinrichting.RVak:READ,UPDATE,DELETE:INSTANCE(1234567890)", "type":"onderwijsinrichting.RVak", "operations":["READ","UPDATE","DELETE"], "instances":["INSTANCE(1234567890)"] } ], "additionalObjects":{}, "afkorting":"schk", "naam":"scheikunde", "UUID":"UUID" } ] }, "actiefVoorGebruiker":true, "isOuderavondUitnodiging":false }, "startPublicatie":"tijd", "verzendDatum":"tijd", "wijzigingsDatum":"tijd", "draft":false, "onderwerp":"REDACTED", "inhoud":"REDACTED", "prioriteit":"NORMAAL", "notificatieType":"Bericht", "bijlages":[ { "links":[ { "id":1234567890, "rel":"koppeling", "type":"berichten.RBoodschapBijlage" } ], "permissions":[], "additionalObjects":{}, "assemblyResults":[ { "links":[ { "id":1234567890, "rel":"koppeling", "type":"cloudfiles.bestanden.RAssemblyResult" } ], "permissions":[], "additionalObjects":{}, "assemblyFileType":"MISC", "fileExtension":"xlsx", "mimeType":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "fileSize":11039, "fileType":"office", "fileUrl":"REDACTED.xlsx", "sslUrl":"REDACTED.xlsx", "fileName":"REDACTED.xlsx" } ], "sortering":0 } ] } ] }, ... ] } ```点击打开
获取学校信息，包括您的导师。 #### 参数 | 名称 | 类型 | 值 | |---------------|--------|-----------------------| | id | URL | [user id] | | Authorization | Header | Bearer [access_token] | #### 返回 ``` { "$type": "leerling.RLeerlingSchoolgegevens", "instellingsnaam": "REDACTED", "vestigingsnaam": "REDACTED", "plaats": "REDACTED", "straat": "REDACTED", "postcode": "REDACTED", "telefoonnummer": "REDACTED", "email": "REDACTED", "leerjaar": 99, "mentoren": [ "REDACTED" ] } ```点击打开
获取学校信息，包括您的导师。 #### 参数 | 名称 | 类型 | 值 | |---------------|--------|-----------------------| | id | URL | [user id] | | Authorization | Header | Bearer [access_token] | #### 返回 ``` { "items": [ { "$type": "participatie.RVakantie", "links": [ { "id": 123456789, "rel": "self", "type": "participatie.RVakantie", "href": "https://api.somtoday.nl/rest/v1/vakanties/123456789" } ], "permissions": [ { "full": "participatie.RVakantie:READ:INSTANCE(123456789)", "type": "participatie.RVakantie", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "naam": "Herfstvakantie", "beginDatum": "2023-10-16T00:00:00.000+02:00", "eindDatum": "2023-10-20T00:00:00.000+02:00" }, ... ] } ```点击打开
获取所有学习资料。（例如年度增刊、在线教科书等。） 首先，向 `GET /rest/v1/vakken/studiemateriaal/[id]` 发出请求。然后使用您想要获取学习资料的科目的 UUID 向 `/rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` 发出请求。 #### 参数 | 名称 | 类型 | 值 | |---------------|--------|-----------------------| | id | URL | [user id] | | Authorization | Header | Bearer [access_token] | #### 返回 `GET /rest/v1/vakken/studiemateriaal/[id]` 返回： ``` { "items": [ { "$type": "onderwijsinrichting.RVak", "links": [ { "id": 123456789, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "https://api.somtoday.nl/rest/v1/vakken/123456789" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(123456789)", "type": "onderwijsinrichting.RVak", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "afkorting": "ne", "naam": "Nederlandse taal", "UUID": "REDACTED" }, ... ] } ``` `GET /rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` 返回： ``` { "$type": "studiewijzer.RStudieMateriaal", "studiewijzer": { "links": [ { "id": 123456789, "rel": "self", "type": "studiewijzer.RStudiewijzer", "href": "https://api.somtoday.nl/rest/v1/studiewijzers/123456789" } ], "permissions": [ { "full": "studiewijzer.RStudiewijzer:READ:INSTANCE(123456789)", "type": "studiewijzer.RStudiewijzer", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "uuid": "Redacted", "naam": "Nederland", "vestiging": { "links": [ { "id": 123456789, "rel": "self", "type": "instelling.RVestiging", "href": "https://api.somtoday.nl/rest/v1/vestigingen/123456789" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(123456789)", "type": "instelling.RVestiging", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "naam": "REDACTED", "uuid": "REDACTED" }, "lesgroep": { "links": [ { "id": 123456789, "rel": "self", "type": "lesgroep.RLesgroep", "href": "https://api.somtoday.nl/rest/v1/lesgroepen/123456789" } ], "permissions": [ { "full": "lesgroep.RLesgroep:READ:INSTANCE(123456789)", "type": "lesgroep.RLesgroep", "operations": [ "READ" ], "instances": [ "INSTANCE(123456789)" ] } ], "additionalObjects": {}, "UUID": "REDACTED", "naam": "REDACTED", "omschrijving": "REDACTED", "schooljaar": { "$type": "onderwijsinrichting.RSchooljaar", "links": [ { "id": 12345689, "rel": "self", "type": "onderwijsinrichting.RSchooljaar", "href": "https://api.somtoday.nl/rest/v1/schooljaren/12345689" } ], "permissions": [ { "full": "onderwijsinrichting.RSchooljaar:READ:INSTANCE(12345689)", "type": "onderwijsinrichting.RSchooljaar", "operations": [ "READ" ], "instances": [ "INSTANCE(12345689)" ] } ], "additionalObjects": {}, "naam": "2023/2024", "vanafDatum": "2023-08-01", "totDatum": "2024-07-31", "isHuidig": true }, "vak": { "links": [ { "id": 12345689, "rel": "self", "type": "onderwijsinrichting.RVak", "href": "https://api.somtoday.nl/rest/v1/vakken/12345689" } ], "permissions": [ { "full": "onderwijsinrichting.RVak:READ:INSTANCE(12345689)", "type": "onderwijsinrichting.RVak", "operations": [ "READ" ], "instances": [ "INSTANCE(12345689)" ] } ], "additionalObjects": {}, "afkorting": "ne", "naam": "Nederlandse taal", "UUID": "REDACTED" }, "heeftStamgroep": false, "examendossierOndersteund": false, "vestiging": { "links": [ { "id": 12345689, "rel": "self", "type": "instelling.RVestiging", "href": "https://api.somtoday.nl/rest/v1/vestigingen/12345689" } ], "permissions": [ { "full": "instelling.RVestiging:READ:INSTANCE(12345689)", "type": "instelling.RVestiging", "operations": [ "READ" ], "instances": [ "INSTANCE(12345689)" ] } ], "additionalObjects": {}, "naam": "REDACTED", "uuid": "REDACTED" } } }, ... } ``` `GET /rest/v1/studiemateriaal/algemeen/[id]` 返回： ``` { "items": [ { "$type": "leermiddel.REduRoutePortalUserProduct", "links": [ { "id": 123456789, "rel": "self", "type": "leermiddel.REduRoutePortalUserProduct", "href": "https://api.somtoday.nl/rest/v1/edurouteportaluserproduct/123456789" } ], "permissions": [ { "full": "leermiddel.REduRoutePortalUserProduct:READ:INSTANCE(123456789)", "type": "leermiddel.REduRoutePortalUserProduct", "operations": ["READ"], "instances": ["INSTANCE(123456789)"] } ], "additionalObjects": {}, "leerling": { "$type": "leerling.RLeerlingPrimer", "links": [ { "id": 9496745174, "rel": "self", "type": "leerling.RLeerlingPrimer", "href": "https://api.somtoday.nl/rest/v1/leerlingen/9496745174" } ], "permissions": [ { "full": "leerling.RLeerlingPrimer:READ:INSTANCE(9496745174)", "type": "leerling.RLeerlingPrimer", "operations": ["READ"], "instances": ["INSTANCE(9496745174)"] } ], "additionalObjects": {}, "UUID": "f8cf6f6c-c213-4526-8ba1-6a306cf724a4", "leerlingnummer": 123456, "roepnaam": "{{first_name}}", "achternaam": "{{last_name}}" }, "product": { "$type": "leermiddel.REduRoutePortalProduct", "links": [ { "id": 1234567890123, "rel": "self", "type": "leermiddel.REduRoutePortalProduct", "href": "https://api.somtoday.nl/rest/v1/edurouteportalproduct/1234567890123" } ], "permissions": [ { "full": "leermiddel.REduRoutePortalProduct:READ:INSTANCE(1234567890123)", "type": "leermiddel.REduRoutePortalProduct", "operations": ["READ"], "instances": ["INSTANCE(1234567890123)"] } ], "additionalObjects": {}, "title": "Chemie Overal ed 5.0 vwo 5 FLEX boek + online", "url": "https://toegang.noordhoff.nl/1234567890123", "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "methodeInformatie": { "$type": "leermiddel.RMethodeInformatie", "links": [ { "id": 1234567890123, "rel": "self", "type": "leermiddel.RMethodeInformatie", "href": "https://api.somtoday.nl/rest/v1/methodeinformatie/1234567890123" } ], "permissions": [ { "full": "leermiddel.RMethodeInformatie:READ:INSTANCE(1234567890123)", "type": "leermiddel.RMethodeInformatie", "operations": ["READ"], "instances": ["INSTANCE(1234567890123)"] } ], "additionalObjects": {}, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "dashboardMethodeNaam": "Chemie overal", "methode": "Chemie overal", "uitgever": "Noordhoff" } }, "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }, ... ] } ```点击打开
获取 icalendar 流 的。 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | #### 返回 ``` { "links": [], "permissions": [], "additionalObjects": {}, "leerlingICalendarLink": "https://api.somtoday.nl/rest/v1/icalendar/stream/REDACTED" } ```点击打开
删除当前活动的 icalendar 流 #### 参数 | 名称 | 类型 | 值 | |---------------|-----------|-----------------------| | Authorization | Header | Bearer [access_token] | #### 返回 无标签：API文档, API集成, Homebrew安装, OAuth2, REST API, SOMtoday, SSO单点登录, 可观测性, 学习指南, 学校API, 学校管理, 学生信息, 开发文档, 成绩查询, 教育科技, 教育系统, 日程管理, 缺勤管理, 荷兰教育