وب سرویس مشاهده نتیجه تست سایکومتریست، شماره تست و پاسخ ها را از طریق پارامترهای ورودی متد GET یا POST دریافت می کند و خروجی را در غالب فرمت های XML و JSON برگشت می دهد.
اگر با JSON آشنائی ندارید می توانید با مراجعه به سایت json.org هم از ساختار فرمت آن مطلع شوید و هم درایور مربوط به زبان برنامه نویسی مورد نظر خود را دریافت نمائید.
{
"status": 200,
"message": "تایید شد.",
"return": {
"credit": 5000,
"currency": "تومان"
}
}برای مشاهده اعتبار کاربر به از متد credit به صورت زیر استفاده می شود:
{
"status": 200,
"message": "تایید شد.",
"return": {
"credit": 5000,
"currency": "تومان"
}
}برای مشاهده لیست تست ها از متد tests به صورت زیر استفاده می شود:
https://api.psychometrist.ir/v1/tests
در نهایت خروجی به صورت زیر خواهد بود:
{
"status": 200,
"message": "تایید شد.",
"return": [
{
"id": 1,
"title": "تست ام ام پی آی فرم بلند (MMPI-2)",
"title_en": "MMPI-2",
"questions_count": 567
},
{
"id": 2,
"title": "تست ام ام پی آی فرم کوتاه (MMPI)",
"title_en": "MMPI",
"questions_count": 71
},
...
]
}برای مشاهده اعتبار کاربر به از متد تست به صورت زیر استفاده می شود:
پارامتر های ورودی :
پارامتر Id شماره منحصربفرد تست مورد نظر می باشید که از وب سرویس مشاهده لیست سوالات می توان id تست مورد نظر را انتخاب کرد.
نمونه خروجی به صورت زیر است:
{ "status": "Success", "message": "تایید شد.", "return": [ { "test_id": 1, "type": "MMPI567", "number": 1, "title": "مجله های فنی را دوست دارم", "description": "", "answers": [ { "choice": 1, "title": "بله", "description": "" }, { "choice": 0, "title": "خیر", "description": "" } ] }, { "test_id": 1, "type": "MMPI567", "number": 2, "title": "اشتهای خوبی دارم", "description": "", "answers": [ { "choice": 1, "title": "بله", "description": "" }, { "choice": 0, "title": "خیر", "description": "" } ] },
.... ]
}برای مشاهده نتیجه آزمون از متد result به صورت زیر استفاده می شود:
https://api.psychometrist.ir/v1/Your-Api-Key/result
پارامتر های ورودی:
پارامتر Id شماره منحصربفرد تست مورد نظر می باشید که از وب سرویس مشاهده لیست تست ها می توان id تست مورد نظر را انتخاب کرد.
پارامتر answers که از نوع String می باشد بدین صورت است که ابتدا شماره سوال و جلوی آن عدد 0 به منزله جواب خیر و عدد 1 به منزله جواب بله است قرار می گیرد.
پارامتر gender جنسیت را مشخص می کند که از نوع String است و به صورت پیش فرض male است این پارامتر می تواند شامل male یا female باشد.
پارامتر type نوع خروجی مشخص می کند به صورت پیش فرض پارامتر type شامل both است که به معنی تفسیر و رسم نمودار است. اگر به این پارامتر interpret فرستاده شود فقط تفسیر آزمون انجام و خروجی داده می شود. اگر به این پارامتر chart فرستاده شود فقط رسم نمودار انجام می شود و به عنوان خروجی نمایش داده می شود.
نمونه خروجی به صورت زیر است:
{
"status": 200,
"message": "تایید شد.",
"return": [
"interpret": "مشکلات را انکار می کنند. ممکن است افرادی ساده و خودمحور باشند و در روابط خود با دیگران به خودنمایی و برون گرایی و رفتارهای ساختگی گرایش یابند. \r\nممکن است تا اندازه ;ای تحریک پذیر بوده و شکایت ;های بدنی را مطرح کنند....",
"chart": {
"L": 53,
"F": 38,
"K": 67,
"Hs": 35,
"D": 39,
"Hy": 51,
"Pd": 40,
"Pa": 35,
"Pt": 27,
"Sc": 24,
"Ma": 42
},
"answers": {
"1": 1,
"2": 1,
"3": 1,
"4": 0,
"5": 0,
"6": 1,
...
}
]
}$url = "https://api.psychometrist.ir/v1/2c53027b5db249b27cc24e2e3f869d8csd23b8/result";
$userAnswers= '{"1":1,"2":1,"3":1,"4":0,"5":0,"6":1,"7":0,"8":0,"9":0,"10":0,"11":0, ...}';
$params = [
'id' => 2,
'answers'=> $userAnswers
];
$handle = curl_init();
curl_setopt($handle, CURLOPT_URL, $url);
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
curl_setopt($handle, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($handle, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($handle, CURLOPT_POST, true);
curl_setopt($handle, CURLOPT_POSTFIELDS, $params);
$response = curl_exec($handle);
echo $response;