Memperoleh kredensial akses pengguna yang telah masuk

​

Langkah 1: Buat aplikasi

1. Masuk ke DingTalk Developer Platform.
2. Buka halaman detail aplikasi yang telah Anda buat. Pada halaman Basic Information, lihat SuiteKey/SuiteSecret (Aplikasi perusahaan pihak ketiga) atau AppKey/AppSecret (Aplikasi internal) milik aplikasi.
3. Pada halaman detail aplikasi, klik Development Configuration > Security Settings, lalu masukkan redirect URI (domain callback).

   Redirect URI adalah alamat yang Anda harapkan menjadi tujuan pengalihan setelah otorisasi masuk.

​

Langkah 2: Otorisasi masuk OAuth

​

Menggunakan halaman otorisasi masuk yang disediakan oleh DingTalk

​

Penting

• Untuk keterbacaan, jeda baris ditambahkan pada contoh parameter berikut. Jeda baris tidak diperlukan dalam penggunaan sebenarnya.
• Nilai parameter harus dienkode dalam format URL. Contoh berikut sudah dienkode dalam format URL.

https://login.dingtalk.io/oauth2/auth?
redirect_uri=https%3A%2F%2Fwww.aaaaa.com%2Fa%2Fb
&response_type=code
&client_id=dingbbbbbbb
&scope=openid corpid
&state=dddd
&prompt=consent

​

Otorisasi masuk dengan Kode QR tersemat

1. Sertakan DingTalk Scan QR Code sign-in JSSDK pada halaman.
   <script src="https://g.alicdn.com/dingding/h5-dingtalk-login/0.21.0/ddlogin.js"></script>
   
2. Panggil metode berikut di tempat yang memerlukan masuk dengan Pindai Kode QR.
   <!-- STEP1: Tambahkan elemen kontainer pembungkus dalam HTML -->
   <div id="self_defined_element" class="self-defined-classname"></div>
   <style>
       /* STEP2: Tentukan gaya CSS untuk elemen kontainer pembungkus ini. Perhatikan secara khusus width dan height. */
       .self-defined-classname {
           width: 300px;
           height: 300px;
       }
   </style>
   <script>
       // STEP3: Saat diperlukan, panggil metode window.DTFrameLogin untuk menyusun Kode QR masuk dan menangani callback berhasil atau gagal.
       window.DTFrameLogin(
           {
               id: 'self_defined_element',
               width: 300,
               height: 300,
           },
           {
               redirect_uri: encodeURIComponent('http://www.aaaaa.com/a/b/'),
               client_id: 'dingxxxxxxxxxxxx',
               scope: 'openid',
               response_type: 'code',
               state: 'xxxxxxxxx',
               prompt: 'consent',
           },
           (loginResult) => {
               const {redirectUrl, authCode, state} = loginResult;
               // Anda dapat mengalihkan langsung di sini
               window.location.href = redirectUrl;
               // Atau gunakan code untuk otorisasi tanpa mengalihkan halaman
               console.log(authCode);
           },
           (errorMsg) => {
               // Biasanya, tampilkan alasan spesifik kegagalan masuk di sini
               alert(`Login Error: ${errorMsg}`);
           },
       );
   </script>
   
   Deskripsi parameter (dalam TypeScript):
   // ********************************************************************************
   // Definisi metode window.DTFrameLogin
   // ********************************************************************************
   window.DTFrameLogin: (
     frameParams: IDTLoginFrameParams, // Parameter terkait kontainer pembungkus DOM
     loginParams: IDTLoginLoginParams, // Parameter masuk terpadu
     successCbk: (result: IDTLoginSuccess) => void, // Fungsi callback saat masuk berhasil
     errorCbk?: (errorMsg: string) => void,         // Fungsi callback saat masuk gagal
   ) => void;
   
   // ********************************************************************************
   // Parameter terkait kontainer pembungkus DOM
   // ********************************************************************************
   // Catatan! Parameter width dan height hanya menetapkan ukuran elemen iframe Kode QR dan tidak memengaruhi ukuran kontainer pembungkus.
   // Ukuran dan gaya kontainer pembungkus harus disetel oleh integrator menggunakan CSS.
   interface IDTLoginFrameParams {
     id: string;      // Wajib. ID elemen kontainer pembungkus, tanpa '#'.
     width?: number;  // Opsional. Lebar elemen iframe Kode QR. Minimum 280. Default 300.
     height?: number; // Opsional. Tinggi elemen iframe Kode QR. Minimum 280. Default 300.
   }
   
   // ********************************************************************************
   // Parameter masuk terpadu
   // ********************************************************************************
   // Arti parameter identik dengan metode integrasi "Construct a link to initiate sign-in authorization" (dengan beberapa parameter dihilangkan).
   // Parameter isPre ditambahkan untuk menyetel lingkungan runtime.
   interface IDTLoginLoginParams {
     redirect_uri: string;     // Wajib. Perhatikan bahwa URL harus dienkode.
     response_type: string;    // Wajib. Nilai tetap code.
     client_id: string;        // Wajib.
     scope: string;            // Wajib. Jika nilainya openid+corpid, parameter org_type dan corpId di bawah ini wajib. Jika tidak, masuk akan gagal.
     prompt: string;           // Wajib. Nilainya consent.
     state?: string;           // Opsional.
     org_type?: string;        // Opsional. Wajib ketika scope adalah openid+corpid.
     corpId?: string;          // Opsional. Wajib ketika scope adalah openid+corpid.
     exclusiveLogin?: string;  // Opsional. Untuk menghasilkan Kode QR khusus organisasi eksklusif, setel ini ke true agar masuk dibatasi hanya untuk akun organisasi.
     exclusiveCorpId?: string; // Opsional. Wajib ketika exclusiveLogin bernilai true. Menentukan corpId organisasi eksklusif.
   }
   
   // ********************************************************************************
   // Hasil masuk yang dikembalikan saat masuk berhasil
   // ********************************************************************************
   interface IDTLoginSuccess {
     redirectUrl: string;   // URL pengalihan setelah masuk berhasil. Integrator dapat langsung menggunakan URL ini untuk pengalihan.
     authCode: string;      // authCode yang diperoleh setelah masuk berhasil. Integrator dapat melakukan autentikasi langsung tanpa mengalihkan halaman.
     state?: string;        // state yang diperoleh setelah masuk berhasil.
   }
   

​

Langkah 3: Peroleh kredensial akses

POST /v1.0/oauth2/userAccessToken HTTP/1.1
Host:api.dingtalk.io
x-acs-dingtalk-access-token:BE3xxxx
Content-Type:application/json

{
  "clientId" : "dingxxx",
  "clientSecret" : "1234",
  "code" : "abcd",
  "refreshToken" : "abcd",
  "grantType" : "authorization_code"
}

​

Langkah 4: Panggil API dengan kredensial akses