Hubungkan dengan Ekosistem App Anda

Fitur developer-grade: kirim riwayat bacaan Al-Quran ke aplikasi eksternal via signed HTTP webhook. Setiap event baca (mulai, selesai, hapus) dikirim secara otomatis ke URL terdaftar dengan keamanan HMAC-SHA256.

Download iOS Download Android

3 Jenis Event Webhook

Setiap aksi pada riwayat baca akan memicu webhook ke semua aplikasi terhubung secara otomatis dan paralel.

X-Event-Type: PUSH

Sesi Baca Disimpan

Dikirim saat pengguna long-press ayat dan tap "Tandai Akhir Baca". Payload berisi metadata lengkap sesi baca.

X-Event-Type: POP

Sesi Baca Dihapus

Dikirim saat pengguna menghapus satu sesi dari riwayat. Payload berisi ID dan detail sesi yang dihapus.

X-Event-Type: CLEAR

Semua Riwayat Dihapus

Dikirim saat pengguna tap "Hapus Semua Riwayat". Payload kosong ({}).

Screenshot: Bottom Sheet Tambah Aplikasi Ukuran: 390×844px. Tampilkan bottom sheet "Tambah Aplikasi": daftar app tersedia (kartu dengan logo + nama + deskripsi, salah satu ter-select dengan radio button orange), di bawahnya field "User ID" dengan placeholder, dan tombol "Hubungkan".

Spesifikasi Teknis

Semua webhook menggunakan POST ke satu base URL dengan header untuk routing dan keamanan.

HTTP Headers

Request Headers

                  HeaderNilaiKeterangan

                  AuthorizationBearer {token}Static token hasil validasi
X-Event-TypePUSH / POP / CLEARJenis event
X-Request-IDUUID v4ID unik per request
X-TimestampISO 8601Waktu pengiriman
X-SignatureHMAC-SHA256 hexTanda tangan body
Content-Typeapplication/json—

Header	Nilai	Keterangan
Authorization	Bearer {token}	Static token hasil validasi
X-Event-Type	PUSH / POP / CLEAR	Jenis event
X-Request-ID	UUID v4	ID unik per request
X-Timestamp	ISO 8601	Waktu pengiriman
X-Signature	HMAC-SHA256 hex	Tanda tangan body
Content-Type	application/json	—

Contoh Payload PUSH

payload.json

                {
  "id": "abc-123",
  "createdAt": "2026-02-18T08:00:00Z",
  "startVerseId": 1,
  "endVerseId": 25,
  "startSurahNumber": 1,
  "startVerseNumber": 1,
  "startPageNumber": 1,
  "startJuzNumber": 1,
  "endSurahNumber": 2,
  "endVerseNumber": 20,
  "endPageNumber": 4,
  "endJuzNumber": 1,
  "pagesCount": 4
}
              

Verifikasi Signature (Node.js)

verify-signature.mjs

              import { createHmac } from 'node:crypto';

function verifySignature(body, secret, receivedSig) {
  const expected = createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return expected === receivedSig;
}

// Di handler Anda:
const isValid = verifySignature(
  rawBody,                    // string JSON dari request
  staticToken,                // token yang Anda simpan dari VALIDATE
  req.headers['x-signature'] // header dari app
);
            

Diagram: Arsitektur Flow Webhook Buat diagram yang menampilkan alur: [Quran App] --PUSH/POP/CLEAR--> [API Eksternal 1] dan [API Eksternal 2]. Tambahkan label header (Authorization, X-Signature, dsb.) pada panah. Format: PNG/SVG, background gelap (#0f172a), lebar 800×400px.

Cara Menghubungkan Aplikasi

Proses koneksi menggunakan APP_ID dari whitelist resmi dan USER_ID dari aplikasi Anda.

1. Daftarkan Aplikasi Anda

Hubungi tim Quran App untuk mendaftarkan APP_ID dan base URL aplikasi Anda ke whitelist resmi.

2. Implementasikan Endpoint VALIDATE

Buat endpoint POST di base URL Anda yang menerima {"userId": "..."} dan mengembalikan {"staticToken": "..."}.

3. Pengguna Hubungkan via App

Di Pengaturan → Aplikasi Terhubung → pilih app → masukkan User ID → tap "Hubungkan". Validasi terjadi otomatis.

4. Terima Webhook Otomatis

Setelah terhubung, setiap sesi baca akan dikirim ke endpoint Anda secara otomatis dengan signature HMAC-SHA256.