# HTML to PDF

> Ubah HTML menjadi PDF dengan teks yang bisa diseleksi dan dicari.

Ubah HTML mentah (maks 2 MB) atau URL publik menjadi PDF: ukuran kertas A4, Letter, Legal, A3, atau A5, orientasi lanskap, margin, nama berkas, serta header dan footer dengan nomor halaman ({page} dan {pages}). Hasilnya berkas application/pdf langsung, atau base64 dalam amplop JSON lewat output=base64. Teksnya tetap bisa diseleksi dan dicari karena PDF dibangun dari teks, bukan dari tangkapan layar. PENTING soal cakupan CSS: mesin render ini bukan browser, jadi flexbox, CSS Grid, dan stylesheet eksternal (<link rel=stylesheet>) TIDAK didukung — yang terbaca adalah style inline dan <style> di dokumen, untuk properti umum seperti warna, border, font, margin, perataan, lebar, dan tinggi. Cocok untuk invoice, kuitansi, laporan, sertifikat, dan tabel; halaman dengan tata letak rumit akan bergeser dari tampilan aslinya di browser. JavaScript tidak pernah dijalankan, sehingga halaman yang isinya digambar JavaScript akan menghasilkan PDF kosong. Gambar diambil hanya dari https publik dalam format JPEG atau PNG (maks 5 MB, 50 gambar); alamat privat atau internal selalu ditolak, juga sesudah resolve DNS. Render dibatasi 20 detik dan 100 halaman.

- Base URL: `https://api.apipedia.id/v1/pdf`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Dokumen
- Halaman: https://apipedia.id/docs/html-to-pdf
- OpenAPI: https://console.apipedia.id/openapi/html-to-pdf.yaml

Semua respons memakai amplop `{ "is_success", "message", "data" }` kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

## Endpoint (1)

- `POST /html`: Render HTML atau URL publik menjadi PDF

### Render HTML atau URL publik menjadi PDF

`POST https://api.apipedia.id/v1/pdf/html`

Mengubah HTML mentah atau halaman web publik menjadi PDF di server compute. Teks hasilnya tetap bisa diseleksi dan dicari karena PDF dibangun dari teks, bukan dari tangkapan layar.

Body: isi TEPAT SATU dari `html` (string, maks 2 MB) atau `url` (http/https publik). Opsi: `format` (A4 bawaan, Letter, Legal, A3, A5), `landscape` (boolean), `margin` `{top,right,bottom,left}` dengan satuan px/in/cm/mm (bawaan 10mm), `displayHeaderFooter` + `headerTemplate`/`footerTemplate` (HTML maks 20 KB; teksnya dipakai apa adanya, dan penanda `{page}` serta `{pages}` diganti nomor halaman), `filename` (nama berkas unduhan).

CAKUPAN CSS - baca sebelum memakai: mesin render ini bukan browser. Flexbox, CSS Grid, dan stylesheet eksternal (`<link rel=stylesheet>`) TIDAK didukung; yang terbaca adalah style inline dan `<style>` di dokumen, untuk properti umum seperti warna, border, font, margin, perataan, lebar, dan tinggi. Cocok untuk invoice, kuitansi, laporan, sertifikat, dan tabel. Halaman dengan tata letak rumit tetap menghasilkan PDF, tapi posisinya akan bergeser dari tampilan aslinya di browser.

JavaScript TIDAK PERNAH dijalankan, jadi halaman yang isinya digambar JavaScript akan menghasilkan PDF kosong. Opsi `javascript`, `scale`, dan `printBackground` sudah tidak berlaku dan diabaikan bila dikirim.

Respons bawaan adalah berkas PDF mentah (`Content-Type: application/pdf`, `Content-Disposition: attachment; filename=...`). Tambahkan `?output=base64` (atau field `output: "base64"`) untuk amplop JSON `{ filename, size, maxPages, base64 }` seperti contoh di bawah.

Keamanan dan batas: gambar diambil oleh server (bukan oleh pustaka PDF) hanya dari https publik dalam format JPEG atau PNG, maks 5 MB per gambar dan 50 gambar; gambar yang gagal diambil dibuang tanpa menggagalkan render. Alamat privat, loopback, link-local, metadata cloud, dan host internal selalu ditolak, termasuk sesudah resolve DNS. Skema lain (file:, ftp:, dsb.) ditolak. Batas: 20 detik total (504), maks 100 halaman (kelebihannya dipotong), PDF maks 20 MB. Antrean penuh dijawab 503 dengan `Retry-After`.

Error: 400 masukan tidak valid / URL privat / halaman gagal diambil; 503 mesin PDF sibuk; 504 melebihi 20 detik.

| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| `output` | query | string | tidak | `pdf` (bawaan, berkas application/pdf) atau `base64` (amplop JSON). Pilihan: `pdf`, `base64`. Default `pdf`. |

Body (`application/json`, wajib):

```json
{
  "html": "<h1>Invoice #INV-2026-001</h1><p>Total: <b>Rp 25.000</b></p>",
  "format": "A4",
  "landscape": false,
  "margin": {
    "top": "20mm",
    "right": "15mm",
    "bottom": "20mm",
    "left": "15mm"
  },
  "displayHeaderFooter": true,
  "footerTemplate": "<div style=\"font-size:8px;text-align:center\">{page} / {pages}</div>",
  "filename": "invoice-2026-001.pdf"
}
```

Contoh request:

```bash
curl -X POST "https://api.apipedia.id/v1/pdf/html?output=base64" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Invoice #INV-2026-001</h1><p>Total: <b>Rp 25.000</b></p>","format":"A4","landscape":false,"margin":{"top":"20mm","right":"15mm","bottom":"20mm","left":"15mm"},"displayHeaderFooter":true,"footerTemplate":"<div style=\"font-size:8px;text-align:center\">{page} / {pages}</div>","filename":"invoice-2026-001.pdf"}'
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "PDF berhasil dibuat",
  "data": {
    "filename": "invoice-2026-001.pdf",
    "size": 48213,
    "maxPages": 100,
    "base64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK..."
  }
}
```

Error khusus endpoint ini:

- **503**: Mesin PDF sedang sibuk (antrean penuh) (`Mesin PDF sedang sibuk. Coba lagi beberapa detik lagi.`)
- **504**: Render melebihi 20 detik (`Render PDF melebihi batas 20 detik.`)
