Memulai
Sumber daya inti
Lainnya
Alur integrasi Tambah ke SEEK Pass
Integrasi Tambahkan ke SEEK Pass mengikuti alur standar untuk mengirimkan data kredensial secara aman dari sistem mitra ke SEEK Pass. Diagram urutan ini menggambarkan proses lengkapnya.
Alur integrasi
Mitra menyiapkan data pengguna untuk payload dalam format JSON berdasarkan jenis kredensial (misalnya kualifikasi pendidikan atau kemampuan bahasa Inggris). Persyaratan detail disediakan untuk setiap jenis kredensial di bagian masing-masing.
Proses integrasi melibatkan langkah-langkah utama berikut:
- 1.Siapkan data dalam format JSON sesuai spesifikasi tipe kredensial
- 2.Autentikasi dengan SEEK Pass untuk mengambil token akses OAuth
- 3.Posting data pengguna untuk menerima URL redirect
- 4.Arahkan pengguna ke URL redirect yang diberikan untuk pengalaman yang mulus
- 5.(Opsional) Periksa status pengajuan untuk memverifikasi apakah pengajuan berhasil, dibatalkan, atau masih sedang berlangsung
Representasi visual
Diagram di bawah ini menggambarkan alur data antara sistem mitra, API SEEK Pass, dan pengguna akhir:
Perjalanan integrasi
Alur kerja integrasi terdiri dari dua fase utama, otentikasi dan pengajuan data pengguna:
Otentikasi menggunakan OAuth
Mulailah dengan melakukan autentikasi dengan SEEK Pass menggunakan OAuth 2.0.
Anda akan menerima client ID dan client secret saat mendaftar sebagai mitra dengan SEEK Pass.
Gunakan kredensial ini dengan Authentication API untuk mendapatkan token akses OAuth untuk panggilan API selanjutnya.
Pengajuan Data
Setelah terautentikasi, siapkan data pengguna Anda dalam format JSON sesuai spesifikasi jenis kredensial yang relevan, seperti Kualifikasi Pendidikan.
Kirim data ini melalui API Tambahkan ke SEEK Pass, yang akan mengembalikan URL pengalihan.
Arahkan pengguna ke URL yang disediakan untuk menyelesaikan pengalaman SEEK Pass mereka dengan lancar.
Anda juga dapat memantau submission status secara opsional untuk melacak apakah prosesnya berhasil, dibatalkan, atau masih sedang berlangsung.
Perjalanan pengguna
- 1.Pengguna masuk ke alur: Pengguna mengklik tautan / memasukkan kode yang disediakan mitra (misalnya, melalui kode / tombol di email).
- 2.Validasi data: Pengguna diarahkan ke API mitra untuk validasi data.
- 3.Pembuatan tautan permintaan: Mitra memanggil API SEEK Pass untuk membuat tautan permintaan dan, jika diperlukan, menampilkan halaman pemuatan.
- 4.Pengalihan pengguna: Pengguna dialihkan ke URL yang disediakan untuk menambahkan kredensial ke SEEK Pass
- 5.Proses verifikasi: Pengguna dipandu melalui alur singkat yang lancar untuk menambahkan kredensial mereka ke SEEK Pass
Implementasi teknis
Untuk detail implementasi teknis, lihat bagian-bagian berikut:
- Otentikasi - Kredensial yang diperlukan dan penyiapan OAuth
- Arahkan pengguna - Alur pengguna dan penanganan URL
- Periksa status pengajuan - Ambil status pengajuan
Praktik terbaik
Untuk hasil integrasi yang optimal:
- Selalu validasi data payload sebelum pengajuan
- Terapkan penanganan kesalahan yang tepat untuk respons API
- Sediakan halaman pemuatan bermerek selama panggilan API
- Ikuti panduan merek SEEK Pass untuk penempatan dan desain tombol
Otentikasi Email OTP – Pertimbangan Domain Mitra
Jika organisasi Anda menggunakan domain email kustom (misalnya @youruniversity.edu.sg), pastikan email OTP (One-Time Password) dari SEEK Pass berhasil terkirim ke akun Anda.
Yang perlu diperiksa
- Gunakan alamat email asli dari domain Anda untuk menguji alur OTP
- Pastikan email OTP tidak diblokir oleh firewall email atau filter spam organisasi Anda
- Pastikan pengguna dapat menyelesaikan proses masuk atau verifikasi menggunakan OTP yang diterima
- Jika Anda tidak dapat menerima email OTP selama pengujian, hubungi tim IT Anda untuk mengizinkan email dari @seek.com.au, @seekpass.co, @seekpass-staging.com (lingkungan staging untuk tujuan pengujian), atau hubungi kontak integrasi SEEK Pass Anda