ReviewerLaunch
https://us1.proctorapi.comBody
Die Reviewer-Anfrage zur Erstellung einer Reviewer-URL.
1, Maximum value is 3600.Der Parameter "domain" ist optional. Durch die Verwendung von "domain" werden die Prüfungsseiten sowie das Reviewer Center mit Ihrer gewünschten Domain geladen.
Die URL wird nicht mehr auf die Seite https://getproctorio.com verweisen. Stattdessen werden die Kandidaten/Reviewer zur neuen Route weitergeleitet, die Sie im Parameter angegeben haben, beispielsweise: https://yourdomain.com.
Dies ermöglicht die Nutzung zusätzlicher Cross-Origin-Sicherheitsmechanismen, die SameSite-Cookies oder den X-Frame-Options: SAMEORIGIN-Header verwenden. Es bietet auch die Möglichkeit, Datenverluste in Session- oder Local-Storage im Zusammenhang mit der Storage-Partitionierungsfunktion des Browsers zu verhindern.
Die Seite https://getproctorio.com hat folgende Funktionen: Prüfung, ob ein Kandidat/Reviewer den unterstützten Browser installiert hat. Prüfung, ob ein Kandidat/Reviewer die Proctorio-Erweiterung installiert hat. Um diese Funktionen beizubehalten, ist ein Link zu https://getproctorio.com mit einer Beschreibung des Zwecks von getproctorio.com auf der Seite der Institution erforderlich.
^[a-zA-Z0-9-]*$.^(?!goodbye$|support$|update$|setup$|invalid$).*.Repräsentiert eine Kurs-ID oder einen Abschnitts-ID-Wert. Dieser Parameter ist optional. Er ermöglicht eine detailliertere Sortierung der Prüfungen.
Das bedeutet, dass Prüfungen mit dem gleichen "exam_tag", aber unterschiedlicher "section_id" als verschiedene Prüfungen behandelt werden.
Der Parameter "section_id" ist vom Parameter "roster_url" abhängig und kann nicht ohne diesen verwendet werden.
URL des Roster-Endpunkts. HTTP-Methode: GET. Die Antwort sollte ein JSON-stringifiziertes Array sein. Beispiel: '[["id1","name1"],["id2","name2"]]'
Der Wert "id" sollte dem Parameter "userId" entsprechen, für den Kandidaten eindeutig und innerhalb des Rosters nicht wiederholbar sein.
Der Roster-Endpunkt wird von Proctorio validiert. Das bedeutet, dass bei Angabe eines ungültigen Endpunkts oder wenn "userId" keinem "id"-Wert im Array entspricht, die Versuche im Review Center als "Nicht zugeordnet" markiert werden.
Die roster_url wird nur vom Endbenutzer abgerufen, der auf das Review Center oder die Prüfungsvereinbarungsseite zugreift, clientseitig, nicht direkt von Proctorio. Das bedeutet, dass sie mit der Sitzung für den jeweiligen Benutzer gesichert werden kann. Dies ist beabsichtigt, und daher müssen personenbezogene Daten zu keinem Zeitpunkt an Proctorio übermittelt werden, weder bei einer Candidate-Launch-Anfrage noch bei einer Reviewer-Launch-Anfrage.
Antworten200application/jsonZeigt Erfolg an und gibt eine Reviewer-URL zurück.
400application/jsonZeigt eine fehlerhafte Anfrage an.
401application/jsonZeigt eine nicht autorisierte Antwort an.
2154 - Konto nicht aktiv.
2155 - Falsche Region.
2655 - Ungültiger api_key.
Zeigt Erfolg an und gibt eine Reviewer-URL zurück.
Zeigt eine fehlerhafte Anfrage an.
Zeigt eine nicht autorisierte Antwort an.
2154 - Konto nicht aktiv.
2155 - Falsche Region.
2655 - Ungültiger api_key.
curl --request POST \
--url https://us1.proctorapi.com/v2/reviewer/launch \
--header 'Content-Type: application/json' \
--header 'api_key: $API_KEY' \
--data '{"exam_settings":{"record_video":true,"record_audio":false,"record_screen":false,"verify_video":false},"user_id":"example-id-123"}'import requests
url = "https://us1.proctorapi.com/v2/reviewer/launch"
payload = {
"exam_settings": {
"record_video": True,
"record_audio": False,
"record_screen": False,
"verify_video": False
},
"user_id": "example-id-123"
}
headers = {
"api_key": "$API_KEY",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())const fetch = require('node-fetch');
const url = 'https://us1.proctorapi.com/v2/reviewer/launch';
const options = {
method: 'POST',
headers: {api_key: '$API_KEY', 'Content-Type': 'application/json'},
body: '{"exam_settings":{"record_video":true,"record_audio":false,"record_screen":false,"verify_video":false},"user_id":"example-id-123"}'
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post,
RequestUri = new Uri("https://us1.proctorapi.com/v2/reviewer/launch"),
Headers =
{
{ "api_key", "$API_KEY" },
},
Content = new StringContent("{\"exam_settings\":{\"record_video\":true,\"record_audio\":false,\"record_screen\":false,\"verify_video\":false},\"user_id\":\"example-id-123\"}")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}{
"exam_settings": {
"record_video": true,
"record_audio": false,
"record_screen": false,
"verify_video": false
},
"user_id": "example-id-123"
}