Riwayat Webhook GET
Ambil riwayat permintaan masuk ke webhook tertentu — apa yang dikirim, apa yang dirender, dan apakah notifikasi berhasil dikirim.
Endpoint
GET https://api.pocketalert.app/v1/webhooks/{tid}/historyAutentikasi
Wajib
Sertakan salah satu header berikut dalam permintaan Anda:
Permintaan
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tid | string | ✅ | Pengenal unik webhook |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Nomor halaman |
per | integer | 50 | Item per halaman (maksimum 200) |
status | string | — | Filter berdasarkan hasil: success atau error |
Contoh Permintaan
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
-H "Token: your-api-key"const tid = 'kblf7mh9j8jjyeh4fx';
const response = await fetch(`https://api.pocketalert.app/v1/webhooks/${tid}/history?per=25`, {
headers: { 'Token': 'your-api-key' }
});
const history = await response.json();import requests
tid = 'kblf7mh9j8jjyeh4fx'
response = requests.get(
f'https://api.pocketalert.app/v1/webhooks/{tid}/history',
headers={'Token': 'your-api-key'},
params={'per': 25, 'status': 'error'}
)
print(response.json())Respons
Respons Sukses
200 OK
Mengembalikan daftar permintaan berhalaman, dari yang terbaru
| Field | Type | Description |
|---|---|---|
requests | array | Permintaan yang tercatat |
total | integer | Total permintaan dalam periode retensi |
page | integer | Halaman saat ini |
per | integer | Item per halaman |
retention_days | integer | Berapa hari riwayat yang disimpan paket Anda (0 = tanpa batas) |
webhook | object | tid, name, url, is_active |
Setiap item di requests:
| Field | Type | Description |
|---|---|---|
id | integer | Pengenal permintaan |
method | string | Metode HTTP yang digunakan pengirim |
source_ip | string | Alamat IP pemanggil |
content_type | string | Tipe konten permintaan |
query | string | Query string mentah |
headers | object | Header permintaan (header sensitif disamarkan) |
body | string | Payload permintaan |
size | integer | Ukuran payload dalam byte |
status | string | success atau error |
error_code | string | Penyebab kegagalan, kosong jika berhasil |
rendered_message | string | Pesan yang dihasilkan dari template Anda |
message_tid | string | Pengenal pesan yang dibuat, kosong jika gagal |
priority | integer | Level notifikasi yang ditetapkan |
duration_ms | integer | Waktu pemrosesan |
created_at | string | Waktu permintaan diterima |
{
"requests": [
{
"id": 412,
"method": "POST",
"source_ip": "140.82.115.16",
"content_type": "application/json",
"query": "",
"headers": { "User-Agent": "GitHub-Hookshot", "Authorization": "[redacted]" },
"body": "{\"repository\":{\"name\":\"pocketalert\"}}",
"size": 38,
"status": "success",
"error_code": "",
"rendered_message": "Push to pocketalert",
"message_tid": "yrst1db64dbbe7euurpmanhdy",
"priority": 1,
"duration_ms": 24,
"created_at": "18.07.2026 16:45:06"
}
],
"total": 1,
"page": 1,
"per": 50,
"retention_days": 90,
"webhook": {
"tid": "kblf7mh9j8jjyeh4fx",
"name": "GitHub Push",
"url": "cs994rqfkk8ljngt",
"is_active": true
}
}Kode Error
Saat status bernilai error, error_code menjelaskan apa yang terjadi:
| Code | Meaning |
|---|---|
inactive | Webhook dinonaktifkan, sehingga tidak ada notifikasi yang dikirim |
invalid_json | Payload tidak dapat diurai sebagai JSON |
empty_message | Template menghasilkan string kosong — biasanya %path% yang tidak ada di payload |
encryption_failed | Pesan tidak dapat dienkripsi |
save_failed | Pesan tidak dapat disimpan |
daily_limit | Batas harian pesan akun telah tercapai. Panggilan menerima 429 dan tidak ada notifikasi yang dikirim; payload dan pesan yang dirender tetap disimpan di sini |
Respons Error
| Status | Description |
|---|---|
401 | Unauthorized — Token tidak valid atau tidak ada |
404 | Not Found — Webhook tidak ditemukan |
Catatan
Retensi
Riwayat disimpan selama jumlah hari tertentu sesuai paket Anda (lihat retention_days): 7 hari untuk Gratis, 30 untuk Starter, 90 untuk Medium, dan 365 untuk Large. Permintaan yang lebih lama dihapus otomatis, begitu pula entri terlama saat satu webhook melebihi 1.000 panggilan yang tercatat.
Privasi
Payload dienkripsi saat disimpan dengan kunci pribadi Anda, sama seperti isi pesan. Header Authorization, cookie, dan kunci API diganti dengan [redacted] sebelum disimpan.