Instal aplikasi Vivoldi dari Google Play untuk membuatnya lebih nyaman.

API Informasi Akun Pengguna

Gunakan token akses untuk mengambil data akun pengguna saat ini.

Periksa informasi penting seperti paket langganan, status verifikasi, dan pengaturan wilayah untuk mendukung logika aplikasi Anda.

API ini tersedia mulai dari paket Personal ke atas.

GET

/api/user/v1/get

HTTP Header 
X-Access-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

No Request Parameters

{
    "code": 0,
    "message": "",
    "result": {
        "eml": "your@gmail.com",
        "nm": "Tester",
        "planNm": "BUSINESS",
        "planExpires": "2025-12-31",
        "locale": "en_US",
        "timeZone": "America/New_York",
        "emlVerifiedYn": "Y",
        "twoAuthYn": "N",
        "sinYmdt": "2025-10-08 03:36:28",
        "regYmdt": "2019-08-13 12:13:01"
    }
}

Response Parameters

codeinteger
Kode respons: 0 = Berhasil, nilai lain = Error
messagestring
Pesan respons. Jika kode tidak sama dengan 0, pesan kesalahan akan dikembalikan.
resultobject
eml string
Email pengguna.
nm string
Nama pengguna.
planNm string
Paket langganan saat ini.
planExpires date
Tanggal kedaluwarsa paket. Kedaluwarsa pada pukul 00:00 berdasarkan Waktu Standar Korea (UTC +09:00).
locale string
Bahasa dan wilayah akun pengguna.
timeZone string
Zona waktu.
Bahasa, wilayah, dan zona waktu dapat diubah di halaman [Pengaturan → Profil].
emlVerifiedYn string
Default:N
Enum:
YN
Status verifikasi email.
Y: Terverifikasi, N: Belum diverifikasi.
twoAuthYn string
Default:N
Enum:
YN
Penggunaan autentikasi dua langkah.
Y: Aktif, N: Nonaktif.
sinYmdt datetime
Waktu login terakhir.
regYmdt datetime
Waktu pembuatan akun.

Kapan menggunakan API ini

Gunakan API ini saat Anda perlu menampilkan informasi pengguna seperti nama atau tingkat langganan di dashboard layanan Anda.

API ini sangat berguna untuk memeriksa masa berlaku paket (planExpires) dan status autentikasi dua faktor (twoAuthYn), sehingga Anda dapat mengontrol akses ke fitur atau memberikan panduan peningkatan keamanan.

Contoh penggunaan

Data respons dapat digunakan dalam berbagai bagian logika aplikasi.

  • Menerapkan pembatasan fitur berdasarkan paket langganan
  • Mengontrol akses berdasarkan status autentikasi
  • Menyesuaikan UI berdasarkan wilayah atau bahasa pengguna
  • Meminta verifikasi tambahan berdasarkan pengaturan 2FA

Singkatnya, API ini berfungsi sebagai input utama yang menentukan perilaku layanan.

Relasi dengan API Autentikasi

API ini hanya dapat digunakan setelah memanggil API Autentikasi.

Alur umum:

  1. Panggil API Autentikasi → dapatkan token
  2. Sertakan token → ambil informasi pengguna

Singkatnya:

  • API Autentikasi → memperoleh izin akses
  • API Data → menggunakan data pengguna

Poin penting dalam operasional

API ini bukan sekadar pengambilan data, melainkan API inti yang menghubungkan kebijakan layanan dengan status pengguna.

  • Logika penagihan berdasarkan paket
  • Penerapan kebijakan keamanan
  • Optimalisasi pengalaman pengguna
  • Kontrol akses fitur

Digunakan sebagai data dasar untuk seluruh logika layanan.

Hal yang perlu diperhatikan

  • Permintaan akan gagal jika token sudah kedaluwarsa.
  • Jangan mengekspos data sensitif langsung di sisi klien.
  • Saat menggunakan cache, perubahan status pengguna mungkin tidak langsung tercermin.
  • Selalu perhatikan logika berdasarkan status verifikasi (emlVerifiedYn).