Dokumentasi

Versi API 1.1

Dokumentasi iki nerangake carane ndhaptar, ngatur, lan ngembangake aplikasi sampeyan supaya sampeyan bisa nggunakake API kita kanthi sukses

Nggawe App

Supaya app sampeyan bisa ngakses API kita, sampeyan kudu ndhaptar app nggunakake Dashboard Aplikasi. Registrasi nggawe ID Aplikasi sing ngidini kita ngerti sapa sampeyan, mbantu kita mbedakake aplikasi sampeyan saka aplikasi liyane.

  1. Sampeyan kudu nggawe App anyar Gawe Aplikasi Anyar
  2. Sawise sampeyan nggawe App sampeyan bakal entuk app_id lan app_secret
Mlebu karo

Log in With system minangka cara sing cepet lan trep kanggo wong nggawe akun lan mlebu menyang aplikasi sampeyan. Sistem Log in With mbisakake rong skenario, otentikasi lan njaluk ijin kanggo ngakses data wong. Sampeyan bisa nggunakake sistem Login Kanthi mung kanggo otentikasi utawa kanggo otentikasi lan akses data.

  1. Miwiti proses login OAuth, Sampeyan kudu nggunakake link kanggo app kaya iki:
    <a href="https://onetouch.co.id/api/oauth?app_id=YOUR_APP_ID">Log in With OneTouch</a>

    Pangguna bakal dialihake menyang Mlebet Kanthi kaca kaya iki

  2. Sawise pangguna nampa app sampeyan, pangguna bakal dialihake menyang URL Pengalihan Aplikasi sampeyan auth_key kaya iki:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Iki auth_key mung sah kanggo panggunaan sepisan, dadi yen sampeyan nggunakake, sampeyan ora bakal bisa nggunakake maneh lan ngasilake kode anyar, sampeyan kudu ngarahake pangguna menyang log in kanthi link maneh.
Akses Token

Sawise sampeyan entuk persetujuan pangguna saka app Log in With jendhela lan bali karo auth_key tegese saiki sampeyan wis siyap njupuk data saka API kita lan kanggo miwiti proses iki, sampeyan kudu menehi wewenang app lan entuk access_token lan sampeyan bisa tindakake langkah kita kanggo sinau carane njaluk iku.

  1. Kanggo entuk token akses, gawe panjalukan HTTP GET menyang titik pungkasan kaya iki:
                <?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
                }
                ?>                                                                                                
                                
    Iki access_token mung sah mung 1 jam, dadi yen ora sah, sampeyan kudu ngowahi sing anyar kanthi ngarahake pangguna menyang log in kanthi pranala maneh.
API

Sawise sampeyan entuk sampeyan access_token Saiki sampeyan bisa njupuk informasi saka sistem liwat panjalukan HTTP GET sing ndhukung paramèter ing ngisor iki

Titik pungkasan Katrangan
api/get_user_info

njaluk info pangguna

Sampeyan bisa njupuk informasi pangguna kaya iki

            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");
            }
                        

Asil bakal:

            {
              "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": ""
              }
            }