Dokumentasi

Versi API 1.1

Dokumentasi ini menjelaskan cara mendaftar, mengonfigurasi, dan mengembangkan aplikasi agar Anda berhasil menggunakan API kami

Buat Aplikasi

Agar aplikasi Anda dapat mengakses API kami, Anda harus mendaftarkan aplikasi Anda menggunakan Dasbor Aplikasi. Pendaftaran membuat ID Aplikasi yang memberi tahu kami siapa Anda, membantu kami membedakan aplikasi Anda dari aplikasi lain.

  1. Anda harus membuat Aplikasi baru Buat Aplikasi Baru
  2. Setelah Anda membuat Aplikasi, Anda akan mendapatkan app_id Dan app_secret
Masuk dengan

Masuk Dengan sistem adalah cara yang cepat dan mudah bagi orang untuk membuat akun dan masuk ke aplikasi Anda. Masuk Dengan sistem kami memungkinkan dua skenario, otentikasi dan meminta izin untuk mengakses data orang. Anda dapat menggunakan sistem Login With hanya untuk autentikasi atau untuk autentikasi dan akses data.

  1. Memulai proses masuk OAuth, Anda perlu menggunakan tautan untuk aplikasi Anda seperti ini:
    <a href="https://onetouch.co.id/api/oauth?app_id=YOUR_APP_ID">Log in With OneTouch</a>

    Pengguna akan diarahkan ke halaman Masuk Dengan seperti ini

  2. Setelah pengguna menyetujui aplikasi Anda, pengguna akan dialihkan ke URL Pengalihan Aplikasi Anda dengan auth_key seperti ini:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Ini auth_key hanya berlaku untuk satu kali penggunaan, jadi setelah Anda menggunakannya Anda tidak akan dapat menggunakannya lagi dan menghasilkan kode baru, Anda perlu mengarahkan pengguna untuk masuk dengan tautan lagi.
Akses Token

Setelah Anda mendapatkan persetujuan pengguna dari aplikasi Anda Masuk Dengan jendela dan kembali dengan auth_key yang berarti sekarang Anda siap mengambil data dari API kami dan untuk memulai proses ini, Anda harus mengotorisasi aplikasi Anda dan mendapatkan access_token dan Anda dapat mengikuti langkah-langkah kami untuk mempelajari cara mendapatkannya.

  1. Untuk mendapatkan token akses, buat permintaan HTTP GET ke endpoint berikut seperti ini:
                <?php
                $app_id = "YOUR_APP_ID"; // your app id
                $app_secret = "YOUR_APP_SECRET"; // your app secret
                $auth_key = $_GET['auth_key']; // the returned auth key from previous step
    
                $get = file_get_contents("https://onetouch.co.id/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
    
                $json = json_decode($get, true);
                if(!empty($json['access_token'])) {
                    $access_token = $json['access_token']; // your access token
                }
                ?>                                                                                                
                                
    Ini access_token valid hanya untuk satu 1 jam, jadi setelah tidak valid, Anda perlu membuat yang baru dengan mengarahkan ulang pengguna untuk masuk dengan tautan lagi.
Lebah

Setelah Anda mendapatkan Anda access_token Sekarang Anda dapat mengambil informasi dari sistem kami melalui permintaan HTTP GET yang mendukung parameter berikut

Titik akhir Keterangan
api/get_user_info

mendapatkan info pengguna

Anda dapat mengambil info pengguna seperti ini

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://onetouch.co.id/api/get_user_info?access_token=$access_token");
            }
                        

Hasilnya akan:

            {
              "user_info": {
              "user_id": "",
              "user_name": "",
              "user_email": "",
              "user_firstname": "",
              "user_lastname": "",
              "user_gender": "",
              "user_birthdate": "",
              "user_picture": "",
              "user_cover": "",
              "user_registered": "",
              "user_verified": "",
              "user_relationship": "",
              "user_biography": "",
              "user_website": ""
              }
            }