# 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

> **Info: Wajib**
>
> Sertakan salah satu header berikut dalam permintaan Anda:
> - `Token: <your-api-key>` — Dapatkan dari [Kunci API](https://pocketalert.app/account/apikeys)
> - `Authorization: Bearer <jwt-token>` — Dari [Masuk](https://info.pocketalert.app/api/user/login.md)

## 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**

```bash
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
  -H "Token: your-api-key"
```

**JavaScript**

```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**

```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

> **Tip: 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 |

```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:

| 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](https://info.pocketalert.app/features/daily-limits.md) 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

> **Warning: 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.

> **Info: Privasi**
>
> Payload dienkripsi saat disimpan dengan kunci pribadi Anda, sama seperti isi pesan. Header Authorization, cookie, dan kunci API diganti dengan `[redacted]` sebelum disimpan.
