Memulai
Sumber daya inti
Lainnya

Rantai mitra

Kolom partner_chain mencatat hubungan perantara dalam hierarki mitra berlapis yang tidak direpresentasikan di bagian lain dalam integrasi. Kolom ini ditujukan untuk digunakan oleh mitra yang menganugerahkan kredensial melalui kolaborasi antara beberapa institusi dan meningkatkan tingkat detail analitik yang dapat SEEK Pass berikan kepada Anda.
Misalnya, hierarki sederhana antara mitra integrasi dan penerbit kredensial berarti semua data yang relevan secara otomatis tercakup tanpa menggunakan partner_chain:
  • Digital Credential Co (mitra integrasi) e28690 data tercatat secara otomatis dalam integrasi melalui otorisasi permintaan
  • University A (penerbit kredensial) e28690 data dicatat sebagai education_provider di kolom kredensial Pendidikan
Bidang partner_chain mencatat hubungan perantara antara mitra integrasi dan penerbit kredensial.
Misalnya, saat mitra integrasi mengelola beberapa institusi atau grup institusi:
  • Digital Credential Co (mitra integrasi) e28690 data tercatat secara otomatis dalam integrasi melalui otorisasi permintaan
  • ABC University Network (jaringan sekolah, mitra dari Digital Credential Co) e28690 entitas ini tidak akan terlihat di analitik tanpa partner_chain
  • University A (penerbit kredensial, anggota ABC University Network) e28690 data dicatat sebagai education_provider di kolom Pendidikan

Catatan

partner_chain direpresentasikan sebagai array agar lapisan relasi lanjutan dapat direpresentasikan. Urutkan elemen dari induk ke anak, di mana induk adalah mitra integrasi dan anak adalah penerbit kredensial.
Hanya sertakan entitas perantara di partner_chain. Jangan sertakan mitra integrasi atau penerbit kredensial, karena keduanya dicatat di bagian lain dalam proses permintaan.
Konsep penerbit kredensial berubah tergantung jenis kredensial, untuk Pendidikan bidangnya adalah education_provider, untuk Learning and Development adalah issuer_name, dan untuk English adalah test_provider. Lihat dokumentasi tiap kredensial untuk bidang yang wajib diisi.

Contoh

Perantara tunggal

  • Digital Credential Co: mitra integrasi yang memanggil API AtSP
  • ABC University Network: Jaringan sekolah, mitra dari Digital Credential Co
  • University A: penerbit kredensial, anggota ABC University Network
Untuk contoh ini, partner_chain hanya mencakup: [{ "name": "ABC University Network" }]

Beberapa Perantara

  • Digital Credential Co: mitra integrasi yang memanggil API AtSP
  • ABC University Network: Jaringan sekolah, mitra dari Digital Credential Co
  • Foo University Group: Kelompok sekolah yang lebih kecil yang diwakili oleh ABC University Network
  • University A: penerbit kredensial, anggota Foo University Group
Untuk contoh ini, partner_chain mencakup: [{ "name": "ABC University Network" }, { "name": "Foo University Group" }]

Tanpa Perantara

  • Digital Credential Co: mitra integrasi yang memanggil API AtSP
  • University A: penerbit kredensial, mitra dari Digital Credential Co
Untuk contoh ini, partner_chain tidak boleh dikirim