Versi API 1.1

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

Buat Aplikasi

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

1. Anda perlu membuat Aplikasi baru Buat Aplikasi Baru
2. Setelah aplikasi dibuat anda akan mendapatkan app_id dan app_secret

Masuk dengan

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

1. Memulai proses login Auth, Anda perlu menggunakan tautan untuk aplikasi Anda seperti ini:

   <a href="https://sapanesia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Sapanesia</a>

   Pengguna akan diarahkan ke halaman Login With seperti ini

   
2. Setelah pengguna menerima aplikasi Anda, pengguna akan diarahkan ke URL Pengalihan Aplikasi Anda dengan auth_key seperti ini:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   Kunci auth_key hanya berlaku untuk satu kali penggunaan, jadi setelah Anda menggunakannya, Anda tidak akan dapat menggunakannya lagi dan membuat kode baru, Anda perlu mengarahkan pengguna ke login 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 perlu 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 titik akhir 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://sapanesia.com/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
   }
   ?>

   Kunci access_token hanya valid untuk satu jam 1, jadi jika tidak valid, Anda perlu membuat yang baru dengan mengarahkan pengguna ke login dengan tautan lagi.

API

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

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://sapanesia.com/api/get_user_info?access_token=$access_token");
}

Hasilnya adalah:

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