API untuk Mendaftarkan Paket Keanggotaan

API untuk Mendaftarkan Paket Keanggotaan

API ini digunakan untuk mendaftarkan paket keanggotaan bagi pengguna di platform. Apabila belum memiliki akun, maka akan sekaligus dibuatkan akun sesuai email. API ini diperuntukkan untuk mitra.

Mendaftarkan Paket Keanggotaan di Platform

• Host: example
• Metode: POST
• Header Content-Type: 'application/json'
• Parameter:
  • membership_id (integer) *
  • email (varchar) *
  • type (integer) *
  • privatekey (varchar) *
  • partner (varchar) *

Keterangan

Simbol * menandakan wajib diisi.

Parameter

1. membership_id - ID paket keanggotaan yang akan didaftarkan kepada anggota platform.
2. email - Email anggota/pengguna platform.
3. type - Jenis/metode pemberian privatekey untuk mitra. Nilai type adalah 1 dan 2. Penjelasan penggunaan ada di poin privatekey.
4. privatekey - Jika nilai type = 1: String/kode hasil hashing menggunakan SHA256 dengan gabungan salt, parttime, email. Pseudocode: $salt = 'salt_dari_mitra'; $parttime = gmdate('Y-m-d'); $email = 'email_mitra@example'; $privatekey = hash('sha256', $salt.$parttime.$email); Jika nilai type = 2: String/kode nilai privatekey langsung menggunakan string salt. Catatan: salt akan diinformasikan bila perjanjian kerjasama sudah ditandatangani.
5. partner - Kode/inisial mitra, setiap mitra mempunyai kode yang berbeda.

Respons API

Format respons API adalah sebagai berikut:

Jika berhasil (berhasil mendaftarkan paket keanggotaan kepada anggota):

Respons akan mengeluarkan status 200. Contoh respons:

Jika tidak berhasil:

Pemberitahuan kenapa tidak berhasil akan diinformasikan di field message pada respons. Respons akan mengeluarkan status 404 (selain 200). Contoh respons: