Dokumentasi API

Panduan lengkap menggunakan PDF AUTORAN API dengan 4 fungsi utama

Authentication

Cara menggunakan API Key

Endpoints

4 fungsi utama API

Contoh Kode

Implementasi langsung

Informasi Dasar API

Base URL dan autentikasi

Base URL

https://api.pdfautoran.com/api/v1

Format Response

// Untuk endpoint PDF (html-to-pdf, merge, stamp, compress):

// Sukses (200) → mengembalikan file PDF (binary)
Content-Type: application/pdf

// Error (4xx / 5xx) → JSON
{
    "message": "Pesan error",
    "detail": "Detail teknis (opsional)"
}

Authentication

Gunakan Bearer Token di header:

Authorization: Bearer YOUR_API_KEY

API Key Anda bisa dilihat di Dashboard

4 Fungsi Utama API

1. HTML to PDF

Konversi konten HTML menjadi file PDF

Endpoint

POST https://api.pdfautoran.com/api/v1/html-to-pdf

Request Body

{
    "html": "<h1>Hello World</h1>",   // HTML penuh yang akan di-render
    "fileName": "dokumen_anda"                // (opsional) nama file tanpa .pdf
}

Response

// Sukses
Status: 200 OK
Content-Type: application/pdf
Body: binary PDF

// Error
Status: 4xx / 5xx
Content-Type: application/json
{
    "message": "Terjadi kesalahan saat mengubah HTML menjadi PDF.",
    "detail": "Pesan error teknis"
}
Lihat contoh kode lengkap

2. Stamp PNG ke PDF

Tambahkan tanda tangan, logo, atau cap ke posisi tertentu dalam PDF

Endpoint

POST https://api.pdfautoran.com/api/v1/stamp

Request Body

{
    "pdfUrl": "https://example.com/document.pdf",   // URL file PDF sumber
    "imageUrl": "https://example.com/stamp.png",    // URL gambar PNG (stamp/tanda tangan)
    "page": 1,                                      // (opsional) halaman target, default 1
    "x": 60,                                        // posisi X dari kiri (satuan point PDF)
    "y": 300,                                       // posisi Y dari bawah
    "width": 80,                                    // (opsional) lebar stamp
    "height": 30,                                   // (opsional) tinggi stamp
    "fileName": "stamped-document"                  // (opsional) nama file output
}

Response

// Sukses
Status: 200 OK
Content-Type: application/pdf
Body: binary PDF hasil stamp

// Error
Status: 4xx / 5xx
Content-Type: application/json
{
    "message": "Terjadi kesalahan saat stamp PNG ke PDF.",
    "detail": "Pesan error teknis"
}
Lihat contoh kode lengkap

3. Merge PDF

Gabungkan beberapa file PDF menjadi satu dokumen

Endpoint

POST https://api.pdfautoran.com/api/v1/merge

Request Body

{
    "urls": [
        "https://example.com/doc1.pdf",
        "https://example.com/doc2.pdf",
        "https://example.com/doc3.pdf"
    ],
    "fileName": "merged-document"   // (opsional) nama file output
}

Response

// Sukses
Status: 200 OK
Content-Type: application/pdf
Body: binary PDF hasil merge

// Error
Status: 4xx / 5xx
Content-Type: application/json
{
    "message": "Terjadi kesalahan saat merge PDF.",
    "detail": "Pesan error teknis"
}
Lihat contoh kode lengkap

4. Compress PDF

Perkecil ukuran file PDF dengan menjaga jumlah halaman tetap sama (low / medium / high).

Endpoint

POST https://api.pdfautoran.com/api/v1/compress

Request Body

{
    "pdfUrl": "https://example.com/source.pdf",  // URL file PDF yang akan dikompres
    "quality": "medium",                         // (opsional) low | medium | high (default: medium)
    "fileName": "compressed-document"           // (opsional) nama file output
}

Response

// Sukses
Status: 200 OK
Content-Type: application/pdf
Body: binary PDF hasil compress (jumlah halaman tetap)

// Error
Status: 4xx / 5xx
Content-Type: application/json
{
    "message": "Terjadi kesalahan saat compress PDF.",
    "detail": "Pesan error teknis"
}
Lihat contoh kode lengkap

🚀 Mulai dalam 2 Menit

1

Dapatkan API Key

Login ke Dashboard dan copy API Key Anda

2

Tambahkan Header

Authorization: Bearer YOUR_API_KEY
3

Kirim Request

Pilih salah satu dari 4 fungsi di atas dan kirim request ke API (HTML_TO_PDF, STAMP, MERGE, atau PDF_COMPRESS).

Selanjutnya apa?

Lihat Contoh Kode Dapatkan API Key