Als Markdown anzeigen

Launchpad

POST/v2/live/launchpad
Basis-URL
https://us1.proctorapi.com
Verfügbare Regionen10 Regionen
Erstellt eine Proctor-Launchpad-URL.
application/json

Body

Die Proctor-Anfrage zur Erstellung einer Proctor-Launchpad-URL.

user_id
stringErforderlich
Muss einen alphanumerischen Wert enthalten (Bindestriche sind ebenfalls zulässig), der für diesen spezifischen Benutzer eindeutig ist.
Format should match: ^[a-zA-Z0-9-]*$.
exam_roster
stringErforderlich
Prüfungslisten-Endpunkt. Enthält eine Liste von exam_name(s), exam_tag(s), section_id(s) und optionaler roster_url.
roster_url
string

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.

expire
integer(int32)
Anzahl der Sekunden, bevor die Proctor-URL nicht mehr gültig ist. Der Standardwert für diesen Parameter beträgt 3600 Sekunden. Wenn kein Wert übergeben wird, wird der Standardwert angewendet. Muss ein ganzzahliger Wert sein.
Minimum value is 1, Maximum value is 3600.
behavior_settings
object
Zeige 2 behavior_settings AttributeVerberge behavior_settings Attribute
frame_metrics
object
Zeige 8 frame_metrics AttributeVerberge frame_metrics Attribute
navigating_away
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn der Kandidat die Prüfungsseite verlässt.
Minimum value is 0, Maximum value is 5.
keystrokes
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio jedes Mal, wenn der Kandidat innerhalb des Prüfungsfensters tippt.
Minimum value is 0, Maximum value is 5.
copy_paste
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn der Kandidat innerhalb des Prüfungsfensters kopiert, ausschneidet oder einfügt.
Minimum value is 0, Maximum value is 5.
browser_resize
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn der Kandidat die Browsergröße während der Prüfung ändert.
Minimum value is 0, Maximum value is 5.
audio_levels
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn die Umgebungsgeräusche einen Pegel über dem Grundrauschen der Prüfungsumgebung erreichen.
Minimum value is 0, Maximum value is 5.
head_movement
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn der Kandidat seinen Kopf vom Prüfungsfenster wegbewegt.
Minimum value is 0, Maximum value is 5.
multiple_faces
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio, wenn mehrere Personen auf eine Prüfung schauen.
Minimum value is 0, Maximum value is 5.
leaving_room
object
Abhängig von der Gewichtung dieser Frame-Metrik markiert Proctorio Kandidaten, die 20-30 Sekunden lang nicht mit Tastatur und Maus interagiert haben und deren Gesicht im Videofeed nicht deutlich sichtbar ist.
Minimum value is 0, Maximum value is 5.
exam_metrics
object
Zeige 14 exam_metrics AttributeVerberge exam_metrics Attribute
navigating_away
boolean
Ungewöhnlich häufiges Verlassen hebt Kandidaten hervor, die externe Anwendungen oder Materialien anders nutzen als der Rest der Gruppe.
keystrokes
boolean
Eine ungewöhnliche Anzahl von Tastatureingaben hebt Kandidaten hervor, die auf Kopieren und Einfügen angewiesen sind oder Schwierigkeiten mit Freitextfragen haben.
copy_paste
boolean
Ungewöhnlich viel Kopieren/Einfügen-Aktivität hebt Kandidaten hervor, die möglicherweise Material aus der Prüfung entnommen oder wiederholt Antworten in die Prüfung eingebracht haben.
browser_resize
boolean
Ungewöhnlich häufige Größenänderung des Browsers hebt Kandidaten hervor, die möglicherweise Notizen oder anderes Material hinter dem Prüfungsfenster versteckt hatten.
audio_levels
boolean
Ungewöhnliche Änderungen der Audiopegel heben Kandidaten hervor, die signifikante Änderungen der Audioaktivität während der Prüfung aufwiesen.
head_movement
boolean
Ungewöhnlich viel Kopfbewegung hebt Kandidaten hervor, die deutlich häufiger oder seltener als der Rest der Gruppe von der Kamera weggeschaut haben.
multiple_faces
boolean
Eine ungewöhnliche Anzahl erkannter Gesichter hebt Kandidaten hervor, die möglicherweise während der Prüfung Hilfe von jemand anderem erhalten haben.
mouse_movement
boolean
Ungewöhnlich viel Mausbewegung hebt Kandidaten hervor, die weniger mit der Prüfungsseite interagiert haben als der Rest der Gruppe.
scrolling
boolean
Ungewöhnlich viel Scrollen hebt Kandidaten hervor, die weniger mit der Prüfungsseite interagiert haben als der Rest der Gruppe.
clicking
boolean
Ungewöhnlich viel Klicken hebt Kandidaten hervor, die weniger mit der Prüfungsseite interagiert haben als der Rest der Gruppe.
exam_duration
boolean
Ungewöhnliche Prüfungsdauer hebt Kandidaten hervor, die deutlich schneller oder langsamer als der Rest der Gruppe fertig geworden sind.
start_time
boolean
Startzeiten heben Kandidaten hervor, deren LMS-Startzeit nicht mit der Proctorio-Startzeit übereinstimmt.
end_time
boolean
Endzeiten heben Kandidaten hervor, deren LMS-Endzeit nicht mit der Proctorio-Endzeit übereinstimmt.
exam_collusion
boolean
Prüfungskollusion hebt Kandidaten hervor, die die Prüfung zur gleichen Zeit im gleichen Netzwerk abgelegt haben.
proctor_settings
object
Zeige 4 proctor_settings AttributeVerberge proctor_settings Attribute
break_allowed
boolean
Diese Option ermöglicht es einem Proctor, einem Kandidaten eine Pause zu gewähren, indem er im Optionsmenü "Pause geben" auswählt. Diese Option ist nur verfügbar, wenn ein Kandidat von einem Proctor beansprucht wurde.
desk_scan_allowed
boolean
Diese Option ermöglicht es einem Proctor, einen Schreibtisch-Scan einzuleiten, indem er im Optionsmenü "Schreibtisch-Scan einleiten" auswählt. Ein Schreibtisch-Scan fordert den Kandidaten auf, seinen Schreibtisch oder seine Umgebung während der Prüfung zu scannen. Diese Option ist nur verfügbar, wenn ein Kandidat von einem Proctor beansprucht wurde.
interrupt_allowed
boolean
Diese Option ermöglicht es einem Proctor, den Versuch eines Kandidaten zu unterbrechen/fortzusetzen. Diese Option ist nur verfügbar, wenn ein Kandidat von einem Proctor beansprucht wurde.
kickout_allowed
boolean
Diese Option ermöglicht es einem Proctor, einen Kandidaten aus seinem Versuch auszuschließen. Diese Option ist nur verfügbar, wenn ein Kandidat von einem Proctor beansprucht wurde.

Antworten

200application/json

Zeigt Erfolg an und gibt eine Proctor-Launchpad-URL zurück.

400application/json

Zeigt eine fehlerhafte Anfrage an.

401application/json

Zeigt eine nicht autorisierte Antwort an.

2154 - Konto nicht aktiv.

2155 - Falsche Region.

2655 - Ungültiger api_key.

POST/v2/live/launchpad
curl --request POST \
  --url https://us1.proctorapi.com/v2/live/launchpad \
  --header 'Content-Type: application/json' \
  --header 'api_key: $API_KEY' \
  --data '{"user_id":"example-id-123","exam_roster":"https://example.com/exam"}'
import requests

url = "https://us1.proctorapi.com/v2/live/launchpad"

payload = {
    "user_id": "example-id-123",
    "exam_roster": "https://example.com/exam"
}
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/live/launchpad';
const options = {
  method: 'POST',
  headers: {api_key: '$API_KEY', 'Content-Type': 'application/json'},
  body: '{"user_id":"example-id-123","exam_roster":"https://example.com/exam"}'
};

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/live/launchpad"),
    Headers =
    {
        { "api_key", "$API_KEY" },
    },
    Content = new StringContent("{\"user_id\":\"example-id-123\",\"exam_roster\":\"https://example.com/exam\"}")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
Anfrage-Beispiele
{
  "user_id": "example-id-123",
  "exam_roster": "https://example.com/exam"
}