Strategi pembangunan_Pihak pelanggan



Prasyarat untuk membaca

Panduan pembangunan ini sesuai untuk proses pengesahan kebenaran mendapatkan Token Akses menggunakan kaedah Implicit Grant Ia sesuai untuk kaedah yang memerlukan akses pelanggan, seperti kod javascript melalui pelayar, atau komputer / terminal mudah alih Apabila diakses oleh pelanggan.

Sebelum membaca panduan pembangunan ini, sila baca [Log Masuk QQ] Menggunakan Geran Tersirat untuk Mendapatkan Token Akses untuk memahami proses pengesahan.

1 Cubalah

1 Lawati pelayar: http://qzs.qq.com/qzone/openapi/client.html .
2. Klik butang "Log Masuk" pada halaman:
Connect_logo_7.png
3 Masukkan akaun QQ dan kata laluan dalam kotak log masuk pop timbul:
OAuth_guide_V2_4.png
4 mengandungi Token Akses:
OAuth_guide_V2_5.png

2 Mulakan dengan cepat

Persediaan

1. Sila pastikan laman web anda telah menghantar apl dan kekunci QQ berjaya. Mohon akses
2. Sila ping openapi.qzone.qq.com pada pelayan anda untuk memastikan sambungan lancar antara laman web dan Qzone.

Langkah1: Letakkan butang log masuk QQ

Laman web perlu memuat turun imej butang "log masuk QQ" dan letakkan butang itu di lokasi yang sesuai pada halaman mengikut spesifikasi UI.
Ikon Butang Muat Turun Butang Spesifikasi Peletakan

Langkah2: Dapatkan Token Akses

1 Buka penyemak imbas dan lawati alamat berikut (sila ganti client_id, redirect_uri, skop dan nilai parameter lain dengan anda sendiri):

https://graph.qq.com/oauth2.0/authorize?response_type=token&client_id=[YOUR_APPID]&redirect_uri=[YOUR_REDIRECT_URI]&scope=[THE_SCOPE]



2. Jika pengguna sudah log masuk, halaman pengesahan akan muncul. Jika anda belum log masuk, halaman log masuk akan muncul, seperti yang ditunjukkan dalam rajah di bawah:
OAuth_guide_V2_3.png
3 Selepas log masuk berjaya, kotak kebenaran akan muncul untuk membimbing pengguna memberi kebenaran (halaman kebenaran hanya akan muncul apabila mengakses OpenAPI buat kali pertama), seperti yang ditunjukkan dalam rajah di bawah :
OAuth_guide_V2_6_client.png
NOTA:
Jika pengguna tidak membenarkannya, operasi akses akan dibatalkan.
Adalah disyorkan bahawa aplikasi pihak ketiga mengawal item kebenaran, iaitu, hanya nama OpenAPI yang mesti digunakan diluluskan dalam skop nilai parameter. Oleh kerana lebih banyak item kebenaran terdapat, lebih besar kemungkinan pengguna menafikan kebenaran.

4 Jika pengguna membenarkan kebenaran, ia akan berjaya melompat ke redirect_uri yang ditentukan, menambah "#" selepas URL, dan membawa Token Akses, expires_in dan parameter lain. Jika sudah ada tanda "#" selepas alamat redirect_uri, tambahkan tanda "&" dan bawa parameter pulangan yang sepadan. Sebagai contoh, alamat panggilan balik ialah: www.qq.com, ia akan melompat ke:

http://www.qq.com/?#access_token=YOUR_ACCESS_TOKEN&expires_in=3600



Istimewa:
1 Redirect_uri yang dihantar semasa permintaan mestilah konsisten dengan alamat panggilan balik yang diisi semasa pendaftaran, dan digunakan untuk pengesahan aplikasi pihak ketiga.
2 Anda boleh menggunakan kaedah js: window.location.hash untuk mendapatkan nilai parameter selepas # dalam URL. Lihat kod sampel di bawah untuk mendapatkan butiran.
3 Adalah disyorkan untuk menggunakan js untuk menetapkan kuki untuk menyimpan token.
4 Token akses yang diperolehi adalah sah selama 3 bulan dan akan dimuat semula secara automatik apabila pengguna log masuk semula.

Langkah3: Gunakan Token Akses untuk mendapatkan OpenID pengguna

1 Hantar permintaan ke alamat berikut (sila gantikan access_token dan nilai parameter lain dengan anda sendiri):

//graph .qq.com/oauth2.0/me?access_token=YOUR_ACCESS_TOKEN

2 Dapatkan OpenID pengguna dan kembalikan pakej berikut:

callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} );

Langkah4: Gunakan Token Akses dan OpenID untuk mengakses dan mengubah suai data pengguna

1 Adalah disyorkan agar tapak web memanggil antara muka get_user_info selepas pengguna log masuk untuk mendapatkan avatar dan nama panggilan pengguna dan memaparkannya di tapak web. untuk meningkatkan pengalaman pengguna bersatu.
2. Panggil OpenAPI lain untuk mengakses dan mengubah suai data pengguna. Untuk butiran tentang semua OpenAPI, sila rujuk dokumen API [Log Masuk QQ].

Ambil panggilan antara muka get_user_info sebagai contoh:
(1) Hantar permintaan ke URL get_user_info (sila gantikan nilai_token_akses, appid dan parameter lain dengan anda sendiri):

https://graph. qq.com/user /get_user_info?access_token=YOUR_ACCESS_TOKEN&oauth_consumer_key=YOUR_APP_ID&openid=YOUR_OPENID



(2) Selepas berjaya kembali, data pengguna boleh diperolehi:



3. Contoh kod

Sampel JavaScript diberikan di bawah (anda hanya perlu mengubah suai sebahagian kod mengikut komen untuk dijalankan)

& lt; html & gt;