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.
- Sampeyan kudu nggawe App anyar Gawe Aplikasi Anyar
- 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.
-
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
-
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.
-
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": "" } }