واجهة برمجة تطبيقات فكونتاكتي هي مجموعة من الأدوات للمطورين لدمج التطبيقات مع شبكة فكونتاكتي الاجتماعية. يسمح لك بالوصول إلى بيانات المستخدم المختلفة مثل معلومات الملف الشخصي والأصدقاء والصور والمزيد. إذا كنت ترغب في إنشاء تطبيق يستخدم وظيفة فكونتاكتي ، تحتاج إلى توصيل أبي فك.
الاتصال إلى أبي فك هو عملية بسيطة تتكون من عدة خطوات. بادئ ذي بدء ، تحتاج إلى إنشاء تطبيق في إعدادات مطور فكونتاكتي. بعد استلام مفاتيح الوصول ، يمكنك الوصول إلى طرق واجهة برمجة التطبيقات. من المهم أن نفهم أن ربط أبي فك يتطلب حساب المطور فكونتاكتي وتسجيل التطبيق.
قبل أن نبدأ ، فمن المستحسن أن تتعرف على وثائق واجهة برمجة التطبيقات فك والقائمة الكاملة للطرق المتاحة لك. تأكد أيضا من أن لديك معرفة أساسية بالبرمجة وفهم أساسيات العمل مع واجهة برمجة التطبيقات.
في هذه المقالة ، سوف ننظر في جميع الخطوات لربط بنجاح أبي فك. سنبدأ بعملية إنشاء تطبيق والحصول على مفاتيح الوصول ، ثم ننتقل إلى أمثلة التعليمات البرمجية للوظائف الأكثر استخداما. سوف نستخدم لغة برمجة بايثون ، ولكن يمكنك تكييف الكود لبيئة التطوير الخاصة بك.
- إذن واستلام رمز الوصول
- إعداد تطبيق فكونتاكتي
- الحصول على معلومات المستخدم
- نشر إدخال على الحائط
إذن واستلام رمز الوصول
للعمل مع واجهة برمجة التطبيقات فك ، تحتاج إلى الذهاب من خلال عملية التفويض والحصول على رمز الوصول التي سيتم استخدامها للوصول إلى بيانات المستخدم.
خطوات التفويض:
- إنشاء تطبيق فكونتاكتي والحصول على معرف ومفتاح آمن.
- إنشاء عنوان ورل للحصول على إذن ، وتحديد قائمة حقوق الوصول اللازمة لبيانات المستخدم.
- إعادة توجيه المستخدم إلى هذا الرابط لتأكيد الوصول.
- احصل على رمز تفويض من فكونتاكتي ، والذي سيتم استخدامه لتلقي رمز وصول.
- باستخدام الرمز المستلم ، أرسل طلبا لتلقي رمز وصول مميز.
- الحصول على رمز الوصول التي سيتم استخدامها للحصول على إذن عند العمل مع أبي فك.
مثال على رابط التفويض:
https://oauth.vk.com/authorize?client_id=YOUR_APP_ID&redirect_uri=YOUR_REDIRECT_URL&scope=PERMISSIONS&response_type=code
- أين:
- معرف التطبيق الخاص بك هو معرف (معرف) التطبيق الخاص بك
- عنوان ورل الخاص بك — عنوان ورل الذي سيتم إعادة توجيه المستخدم إليه بعد التفويض
الأذونات-حقوق الوصول المطلوبة إلى بيانات المستخدم (على سبيل المثال ، الأصدقاء والصور والمجموعات)
الرمز-معلمة تشير إلى استلام رمز التفويض
بعد التفويض الناجح ، سيتم إعادة توجيه المستخدم إلى عنوان ورل المحدد ، مع معلمة التعليمات البرمجية ، والتي سيتم استخدامها لاحقا للحصول على رمز وصول.
مثال على طلب للحصول على رمز وصول:
- https://oauth.vk.com/access_token?client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&redirect_uri=YOUR_REDIRECT_URL&code=CODE
- أين:
معرف التطبيق الخاص بك هو معرف (معرف) التطبيق الخاص بك
سر التطبيق الخاص بك-المفتاح الآمن للتطبيق الخاص بك
عنوان ورل الخاص بك — عنوان ورل الذي تمت إعادة توجيه المستخدم إليه بعد التفويض
الرمز-رمز التفويض المستلم من فكونتاكتي
بعد تنفيذ هذا الطلب ، سيتم تلقي استجابة جسون ، والتي سوف تحتوي على رمز الوصول ، والتي ستكون مطلوبة لمزيد من العمل مع واجهة برمجة التطبيقات فك.
مثال على استجابة جسون:
- {
- "الوصول":"الوصول",
- "إكسبيريس_في": 86400,
- "معرف المستخدم": 123456789
- }
- الخاص بك هو رمز الوصول المستلم الذي سيتم استخدامه للعمل مع واجهة برمجة التطبيقات فك.
- إعداد تطبيق فكونتاكتي
لاستخدام واجهة برمجة التطبيقات فك ، تحتاج إلى تسجيل التطبيق في فكونتاكتي والحصول على مفتاح أبي.
فيما يلي تعليمات خطوة بخطوة حول كيفية إعداد تطبيق فكونتاكتي:
انتقل إلى موقع فكونتاكتي وقم بتسجيل الدخول إلى حسابك.
انتقل إلى صفحة فكونتاكتي الخاصة بالمطور باستخدام الرابط: https://vk.com/dev .انقر فوق الزر" إنشاء تطبيق".
املأ حقلي" الاسم "و" الارتباط بالموقع".
حدد الإعدادات التي تحتاجها للتطبيق (على سبيل المثال ، ما إذا كان يجب أن يكون خاصا أو يستخدم واجهة برمجة تطبيقات رد الاتصال).قم بتأكيد إنشاء التطبيق عن طريق إدخال كلمة التحقق أو تأكيد رقم الهاتف.
احصل على مفتاح واجهة برمجة التطبيقات للتطبيق الخاص بك. يرجى ملاحظة أنه بالنسبة لبعض وظائف واجهة برمجة التطبيقات فك ، سوف تحتاج إلى الحصول على الحقوق المناسبة (على سبيل المثال ، الوصول إلى بيانات المستخدم).
الحصول على معلومات المستخدم
طلب مثال:
الحصول على https://api.vk.com/method/users.get?user_ids=1&fields=photo_100,city,country&access_token=YOUR_TOKEN&v=API_VERSION
| ردا على الطلب ، سوف تتلقى كائن جسون مع معلومات عن المستخدم ، بما في ذلك هويته ، الاسم الأول ، اسم العائلة ، الصورة ، المدينة ، البلد وغيرها من المعلومات. | مثال على الاستجابة: |
|---|---|
| { | "الرد": [ |
| { | "معرف": 1, |
"صور_100":"https://sun9-13.userapi.com/impg/c858120/v858120001/1ae6d/DKl2kqXz-hA.jpg?size=100x100&quality=96&sign=414a73d7f4017d539c0223c559f4e442&type=album" ,
"صور_200": "https://sun9-13.أوسيرابي .كوم / إمبغ / سي 858120 / في 858120001/1 إي 6 د/دكل 2 ككس-ها.جي بي جي?الحجم=200 * 200 والجودة=96 والتوقيع=414 أ 73 د 7 أ 4017 د 539 ج 0223 ج 559 أ 4 هـ 442 والنوع=الألبوم" ,"العنوان":"سانت بطرسبرغ"
},