Pinlocus untuk bisnis
Baca Pinlocus id menjadi nomor telepon, alamat email, atau alamat rumah terkini langsung dari sistem Anda sendiri.
Pencarian terbuka, satu parameter
Satu permintaan tanpa kunci, hanya berisi Pinlocus id, mengembalikan telepon, email dan alamat aktif yang sudah publik — persis isi halaman /p/{id}. Catatan yang ditandai khusus mitra tetap memerlukan lisensi.
curl https://pinlocus.goldenwakaf.id/api/v1/lookup/10000
1. Memperoleh access token
curl -X POST https://pinlocus.goldenwakaf.id/api/v1/token \
-H "Content-Type: application/json" \
-d '{"grant_type":"client_credentials","client_id":"pk_live_xxx","client_secret":"yyy"}'
2. Membaca sebuah id
curl https://pinlocus.goldenwakaf.id/api/v1/pincodes/ABCD \ -H "Authorization: Bearer <access_token>"
Daftar endpoint
| Endpoint | Cakupan | Mengembalikan |
|---|---|---|
| GET /api/v1/pincodes/{id} | address | Seluruh data yang boleh dibaca kunci tersebut |
| GET /api/v1/pincodes/{id}/phone | phone | Nomor telepon yang aktif |
| GET /api/v1/pincodes/{id}/email | Alamat email yang aktif | |
| GET /api/v1/pincodes/{id}/address | address | Alamat dan titik peta yang aktif |
| GET /api/v1/pincodes/{id}/availability | availability | Apakah sebuah id ada, tanpa membuka data apa pun |
| POST /api/v1/webhooks | address | Berlangganan notifikasi perubahan untuk satu id |
| GET /api/v1/usage | availability | Jumlah panggilan dan sisa kuota Anda sendiri |
| GET /api/v1/lookup/{id} | — | Telepon, email dan alamat aktif yang publik. Tanpa kunci. |
Id tidak dikenal versus data kosong
Id yang tidak dikenal menghasilkan kode not_found dengan id_exists bernilai false. Id yang ada tetapi tidak punya data aktif jenis itu menghasilkan no_active_record dengan id_exists bernilai true. Integrasi harus membedakan keduanya.
Memverifikasi notifikasi
Setiap panggilan membawa header X-Pinlocus-Signature berisi HMAC-SHA256 atas isi pesan dengan kunci signing secret Anda. Tolak panggilan yang tanda tangannya tidak cocok.