LiveLaunch
https://us1.proctorapi.comBody
試験監督ライブ URL を作成するための試験監督リクエスト。
1, Maximum value is 3600.^[a-zA-Z0-9-]*$.^(?!goodbye$|support$|update$|setup$|invalid$).*.コース ID またはセクション ID の値を表します。このパラメータはオプションです。試験のより詳細なソートを提供します。
これは、同じ "exam_tag" でも異なる "section_id" を持つ試験が、異なる試験として扱われることを意味します。
"section_id" パラメータは "roster_url" パラメータに依存しており、それなしでは使用できません。
名簿のエンドポイント URL です。HTTP メソッド: GET。レスポンスは JSON 文字列化された配列である必要があります。例: '[["id1","name1"],["id2","name2"]]'
"id" の値は "userId" パラメータに対応し、受験者に固有で、名簿内で重複しないものである必要があります。
名簿エンドポイントは Proctorio によって検証されるため、無効なエンドポイントが提供された場合、または "userId" が配列内のいずれの "id" 値とも一致しない場合、試行は Review Center で「Unmatched」としてマークされます。
roster_url は Review Center または試験同意ページにアクセスするエンドユーザーによってクライアントサイドでフェッチされ、Proctorio が直接フェッチするものではありません。そのため、特定のユーザーのセッションで保護できます。これは意図的なものであり、受験者起動リクエストやレビューアー起動リクエストにおいて、PII を Proctorio に渡す必要はありません。
レスポンス200application/json成功を示し、試験監督 URL を返します。
400application/json不正なリクエストを示します。
401application/json未承認のレスポンスを示します。
2154 - アカウントが有効ではありません。
2155 - リージョンが正しくありません。
2655 - api_key が無効です。
成功を示し、試験監督 URL を返します。
不正なリクエストを示します。
未承認のレスポンスを示します。
2154 - アカウントが有効ではありません。
2155 - リージョンが正しくありません。
2655 - api_key が無効です。
curl --request POST \
--url https://us1.proctorapi.com/v2/live/launch \
--header 'Content-Type: application/json' \
--header 'api_key: $API_KEY' \
--data '{"user_id":"example-id-123"}'import requests
url = "https://us1.proctorapi.com/v2/live/launch"
payload = { "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/live/launch';
const options = {
method: 'POST',
headers: {api_key: '$API_KEY', 'Content-Type': 'application/json'},
body: '{"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/live/launch"),
Headers =
{
{ "api_key", "$API_KEY" },
},
Content = new StringContent("{\"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);
}{
"user_id": "example-id-123"
}