إصدار ‏‎Graph API‎‏

Debug-Token /debug_token

تعمل نقطة النهاية هذه على إرجاع بيانات التعريف حول رمز وصول محدد. ويتضمن ذلك بيانات مثل المستخدم الذي تم إصدار الرمز له، وما إذا كان الرمز لا يزال صالحًا وموعد انتهاء صلاحيته والأذونات التي يمتلكها التطبيق للمستخدم المحدد.

قد يتم استخدام هذا لتصحيح الأخطاء المرتبطة بمجموعات كبيرة من رموز الوصول برمجيًا.

القراءة

مستكشف Graph API
GET /v19.0/debug_token?input_token={input-token} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/debug_token?input_token={input-token}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/debug_token?input_token={input-token}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/debug_token?input_token={input-token}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/debug_token?input_token={input-token}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

الأذونات

المعلمات

الاسم الوصف النوع

input_token

يمثل رمز الوصول الذي يتم فحصه. يجب تحديد هذه المعلمة.

string

الحقول

الاسمالوصفالنوع

data

يمثل أداة تضمين البيانات حول النتيجة.

object

app_id

يمثل معرف التطبيق الذي يتم تخصيص رمز الوصول هذا له.

string

application

يمثل اسم التطبيق الذي يتم تخصيص رمز الوصول هذا له.

string

error

يمثل أي خطأ قد يقوم الطلب المقدم لواجهة graph api بإرجاعه بسبب رمز الوصول.

object

code

يمثل رمز الخطأ.

int

message

يمثل رسالة الخطأ.

string

subcode

يمثل الرمز الفرعي للخطأ.

int

expires_at

يمثل الطابع الزمني الذي يشير إلى موعد انتهاء صلاحية رمز الوصول هذا.

unixtime

data_access_expires_at

يمثل الطابع الزمني الذي يشير إلى موعد انتهاء صلاحية وصول التطبيق إلى بيانات المستخدم.

unixtime

is_valid

يشير إلى ما إذا كان رمز الوصول لا يزال صالحًا أم لا.

bool

issued_at

يمثل الطابع الزمني الذي يشير إلى موعد إصدار رمز الوصول هذا.

unixtime

metadata

يمثل بيانات التعريف العامة المرتبطة برمز الوصول. ويحتوي على بيانات، مثل "sso" و"auth_type" و"auth_nonce"

object

profile_id

يمثل معرف الصفحة الذي يحتوي عليه هذا الرمز، بالنسبة لرموز الوصول التي تم انتحالها.

string

scopes

يمثل قائمة الأذونات التي منحها المستخدم للتطبيق في رمز الوصول هذا.

string[]

granular_scopes

يمثل قائمة الأذونات التفصيلية التي منحها المستخدم للتطبيق في رمز الوصول هذا. وإذا كان الإذن ينطبق على الكل، فلن يتم عرض الأهداف.

shape('scope' => string,'target_ids' => ?int[],)[]

user_id

يمثل معرف المستخدم الذي يتم تخصيص رمز الوصول هذا له.

string

النشر والحذف

لا يمكنك تنفيذ هذه الإجراءات على عنصر الربط هذا.