Langsung ke konten

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}/history

Autentikasi ​

Wajib

Sertakan salah satu header berikut dalam permintaan Anda:

  • Token: <your-api-key> — Dapatkan dari Kunci API
  • Authorization: Bearer <jwt-token> — Dari Masuk

Permintaan ​

Path Parameters ​

ParameterTypeRequiredDescription
tidstring✅Pengenal unik webhook

Query Parameters ​

ParameterTypeDefaultDescription
pageinteger1Nomor halaman
perinteger50Item per halaman (maksimum 200)
statusstring—Filter berdasarkan hasil: success atau error

Contoh Permintaan ​

bash
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
  -H "Token: your-api-key"
javascript
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();
python
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

FieldTypeDescription
requestsarrayPermintaan yang tercatat
totalintegerTotal permintaan dalam periode retensi
pageintegerHalaman saat ini
perintegerItem per halaman
retention_daysintegerBerapa hari riwayat yang disimpan paket Anda (0 = tanpa batas)
webhookobjecttid, name, url, is_active

Setiap item di requests:

FieldTypeDescription
idintegerPengenal permintaan
methodstringMetode HTTP yang digunakan pengirim
source_ipstringAlamat IP pemanggil
content_typestringTipe konten permintaan
querystringQuery string mentah
headersobjectHeader permintaan (header sensitif disamarkan)
bodystringPayload permintaan
sizeintegerUkuran payload dalam byte
statusstringsuccess atau error
error_codestringPenyebab kegagalan, kosong jika berhasil
rendered_messagestringPesan yang dihasilkan dari template Anda
message_tidstringPengenal pesan yang dibuat, kosong jika gagal
priorityintegerLevel notifikasi yang ditetapkan
duration_msintegerWaktu pemrosesan
created_atstringWaktu permintaan diterima
json
{
  "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:

CodeMeaning
inactiveWebhook dinonaktifkan, sehingga tidak ada notifikasi yang dikirim
invalid_jsonPayload tidak dapat diurai sebagai JSON
empty_messageTemplate menghasilkan string kosong — biasanya %path% yang tidak ada di payload
encryption_failedPesan tidak dapat dienkripsi
save_failedPesan tidak dapat disimpan
daily_limitBatas 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 ​

StatusDescription
401Unauthorized — Token tidak valid atau tidak ada
404Not 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.

Dokumentasi Pocket Alert