كيفية إنشاء رمز وصول وإجراء استدعاء API إلى ماي سكول

لإجراء استدعاء API إلى ماي سكول، أنشئ أولًا رمز وصول (Access Token)، ثم استخدمه لاستدعاء API.

1. تسجيل تطبيق العميل في ماي سكول

1. انتقل إلى الإعدادات ← إدارة العملاء.
2. انقر على جديد لإضافة عميل جديد.
3. أدخل الاسم ورابط إعادة التوجيه (Redirect URI)، وحدّد موثّق.
4. احفظ العميل. سيتم إنشاء معرّف العميل (Client ID) والرمز السري للعميل (Client Secret)، وستستخدمهما لإنشاء رمز الوصول.

2. إنشاء رمز الوصول

مرّر معرّف العميل والرمز السري واسم المستخدم وكلمة المرور إلى نقطة إنشاء الرمز. مثال على الشيفرة:

function get_token(username, password) {
  var xhr = new XMLHttpRequest();
  xhr.open("POST", "https://yourschool.myschool.ly/oauth/token", true);
  xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
  xhr.onreadystatechange = function (e) {
    if (xhr.readyState == 4 && xhr.status == 200) {
      console.log(e.target.responseText);
    }
  };
  var token = xhr.send(
    "client_id=YOUR_CLIENT_ID" +
    "&client_secret=YOUR_CLIENT_SECRET" +
    "&grant_type=password" +
    "&username=" + username +
    "&password=" + password +
    "&redirect_uri=http://localhost:3001/authorize"
  );
  return token;
}

استدعِ هذه الدالة مع تمرير اسم المستخدم وكلمة المرور كمعاملات.

3. استدعاء API

استدعِ API مع تمرير الرمز ومسار المورد الذي تريد قراءة بياناته أو إرسالها. مثال على الدالة:

function callApi(token, path) {
  var httpRequest = new XMLHttpRequest();
  httpRequest.onreadystatechange = function (evt) {
    console.log("xhr.readyState :: " + httpRequest.readyState);
    console.log("xhr.status :: " + httpRequest.status);
    if (httpRequest.readyState == 4 && httpRequest.status == 200) {
      console.log(evt.target.responseText);
    }
  };
  httpRequest.open("GET", "https://yourschool.myschool.ly/api/" + path);
  httpRequest.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
  httpRequest.setRequestHeader("Authorization", 'Token token="' + token + '"');
  httpRequest.send();
}

ستحتوي الاستجابة على البيانات المطلوبة.

ملاحظة: استبدل yourschool.myschool.ly بعنوان موقع ماي سكول الخاص بمدرستك، واستبدل http://localhost:3001/authorize برابط إعادة التوجيه الخاص بتطبيق العميل. معرّف العميل والرمز السري والروابط الواردة هنا أمثلة توضيحية فقط.

انظر أيضًا: ما الذي يمكنني فعله باستخدام API ماي سكول؟ في قسم API.