Contoh Penggunaan

HTML to PDF

Konversi konten HTML (string) menjadi file PDF

JavaScript (Fetch API)

example-html-to-pdf.js

async function convertHtmlToPdf() {
    const apiKey = 'YOUR_API_KEY_HERE';
    const apiUrl = 'https://api.pdfautoran.com/api/v1/html-to-pdf';

    // HTML yang akan di-convert ke PDF
    const htmlContent = `
        <html>
          <head>
            <title>Contoh PDF</title>
          </head>
          <body>
            <h1 style="color:#2563eb;">Hello PDF AUTORAN</h1>
            <p>Ini contoh dokumen yang dibuat dari HTML string.</p>
          </body>
        </html>
    `;

    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            html: htmlContent,
            fileName: 'contoh-html-to-pdf'
        })
    });

    if (!response.ok) {
        let errorBody = null;
        try {
            errorBody = await response.json();
        } catch (_) {
            errorBody = { message: 'Unknown error' };
        }
        console.error('Error:', errorBody.message || 'Gagal generate PDF');
        return;
    }

    // Response sukses = file PDF (binary)
    const blob = await response.blob();
    const url = window.URL.createObjectURL(blob);

    // Download otomatis
    const a = document.createElement('a');
    a.href = url;
    a.download = 'contoh-html-to-pdf.pdf';
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

Python (requests)

html_to_pdf.py

import requests

def convert_html_to_pdf():
    api_key = "YOUR_API_KEY_HERE"
    api_url = "https://api.pdfautoran.com/api/v1/html-to-pdf"

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    }

    data = {
        "html": """
        <html>
          <body>
            <h1 style='color:#2563eb;'>Hello PDF AUTORAN</h1>
            <p>Contoh dokumen dari HTML di Python.</p>
          </body>
        </html>
        """,
        "fileName": "contoh-html-to-pdf",
    }

    response = requests.post(api_url, headers=headers, json=data)

    if response.status_code == 200:
        with open("contoh-html-to-pdf.pdf", "wb") as f:
            f.write(response.content)
        print("PDF berhasil dibuat: contoh-html-to-pdf.pdf")
    else:
        try:
            print("Error:", response.json())
        except ValueError:
            print("Error:", response.text)

PHP (Guzzle)

html_to_pdf.php

<?php

require 'vendor/autoload.php';

use GuzzleHttp\Client;

function convertHtmlToPdf() {
    $apiKey = 'YOUR_API_KEY_HERE';
    $apiUrl = 'https://api.pdfautoran.com/api/v1/html-to-pdf';

    $client = new Client();

    try {
        $response = $client->post($apiUrl, [
            'headers' => [
                'Authorization' => 'Bearer ' . $apiKey,
                'Content-Type'  => 'application/json',
            ],
            'json' => [
                'html' => '<h1 style="color:#2563eb;">Hello PDF AUTORAN</h1><p>Contoh dokumen dari HTML di PHP.</p>',
                'fileName' => 'contoh-html-to-pdf',
            ],
        ]);

        if ($response->getStatusCode() === 200) {
            file_put_contents('contoh-html-to-pdf.pdf', $response->getBody());
            echo "PDF berhasil dibuat: contoh-html-to-pdf.pdf";
        } else {
            $body = json_decode((string) $response->getBody(), true);
            echo "Error: " . ($body['message'] ?? 'Gagal generate PDF');
        }
    } catch (Exception $e) {
        echo "Request failed: " . $e->getMessage();
    }
}

cURL Command

Terminal Command

curl -X POST "https://api.pdfautoran.com/api/v1/html-to-pdf" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Hello PDF AUTORAN</h1><p>Contoh dokumen dari HTML.</p>",
    "fileName": "contoh-html-to-pdf"
  }' \
  --output contoh-html-to-pdf.pdf

Stamp PNG to PDF

Tempelkan tanda tangan / logo PNG ke posisi tertentu di PDF

JavaScript (Fetch API)

example-stamp-pdf.js

async function stampPdf() {
    const apiKey = 'YOUR_API_KEY_HERE';
    const apiUrl = 'https://api.pdfautoran.com/api/v1/stamp';

    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            pdfUrl: 'https://example.com/document.pdf',
            imageUrl: 'https://example.com/stamp.png',
            page: 1,        // halaman ke-1
            x: 60,          // posisi X dari kiri (point)
            y: 300,         // posisi Y dari bawah (point)
            width: 80,      // lebar stamp
            height: 30,     // tinggi stamp
            fileName: 'hasil-stamp'
        }),
    });

    if (!response.ok) {
        let errorBody = null;
        try {
            errorBody = await response.json();
        } catch (_) {
            errorBody = { message: 'Unknown error' };
        }
        console.error('Error:', errorBody.message || 'Gagal stamp PDF');
        return;
    }

    const blob = await response.blob();
    const url = window.URL.createObjectURL(blob);

    const a = document.createElement('a');
    a.href = url;
    a.download = 'hasil-stamp.pdf';
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

Python (requests)

stamp_pdf.py

import requests

def stamp_pdf():
    api_key = "YOUR_API_KEY_HERE"
    api_url = "https://api.pdfautoran.com/api/v1/stamp"

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    }

    data = {
        "pdfUrl": "https://example.com/document.pdf",
        "imageUrl": "https://example.com/stamp.png",
        "page": 1,
        "x": 60,
        "y": 300,
        "width": 80,
        "height": 30,
        "fileName": "hasil-stamp",
    }

    response = requests.post(api_url, headers=headers, json=data)

    if response.status_code == 200:
        with open("hasil-stamp.pdf", "wb") as f:
            f.write(response.content)
        print("PDF hasil stamp disimpan sebagai hasil-stamp.pdf")
    else:
        try:
            print("Error:", response.json())
        except ValueError:
            print("Error:", response.text)

Merge PDF

Gabungkan beberapa PDF menjadi satu file (urutan mengikuti array)

JavaScript (Fetch API)

example-merge-pdf.js

async function mergePdfs() {
    const apiKey = 'YOUR_API_KEY_HERE';
    const apiUrl = 'https://api.pdfautoran.com/api/v1/merge';

    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            urls: [
                'https://example.com/doc1.pdf',
                'https://example.com/doc2.pdf',
                'https://example.com/doc3.pdf',
            ],
            fileName: 'hasil-merge'
        }),
    });

    if (!response.ok) {
        let errorBody = null;
        try {
            errorBody = await response.json();
        } catch (_) {
            errorBody = { message: 'Unknown error' };
        }
        console.error('Error:', errorBody.message || 'Gagal merge PDF');
        return;
    }

    const blob = await response.blob();
    const url = window.URL.createObjectURL(blob);

    const a = document.createElement('a');
    a.href = url;
    a.download = 'hasil-merge.pdf';
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

cURL Command

Terminal Command

curl -X POST "https://api.pdfautoran.com/api/v1/merge" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/doc1.pdf",
      "https://example.com/doc2.pdf",
      "https://example.com/doc3.pdf"
    ],
    "fileName": "hasil-merge"
  }' \
  --output hasil-merge.pdf

Compress PDF

Perkecil ukuran file PDF tanpa mengubah jumlah halaman (low / medium / high).

JavaScript (Fetch API)

example-compress-pdf.js

async function compressPdf() {
    const apiKey = 'YOUR_API_KEY_HERE';
    const apiUrl = 'https://api.pdfautoran.com/api/v1/compress';

    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            pdfUrl: 'https://example.com/source.pdf',
            quality: 'medium',          // optional: low | medium | high
            fileName: 'hasil-compress'  // optional
        }),
    });

    if (!response.ok) {
        let errorBody = null;
        try {
            errorBody = await response.json();
        } catch (_) {
            errorBody = { message: 'Unknown error' };
        }
        console.error('Error:', errorBody.message || 'Gagal compress PDF');
        return;
    }

    const blob = await response.blob();
    const url = window.URL.createObjectURL(blob);

    const a = document.createElement('a');
    a.href = url;
    a.download = 'hasil-compress.pdf';
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
}

Python (requests)

compress_pdf.py

import requests

def compress_pdf():
    api_key = "YOUR_API_KEY_HERE"
    api_url = "https://api.pdfautoran.com/api/v1/compress"

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    }

    data = {
        "pdfUrl": "https://example.com/source.pdf",
        "quality": "medium",           # low / medium / high
        "fileName": "hasil-compress",
    }

    response = requests.post(api_url, headers=headers, json=data)

    if response.status_code == 200:
        with open("hasil-compress.pdf", "wb") as f:
            f.write(response.content)
        print("PDF terkompress: hasil-compress.pdf")
    else:
        try:
            print("Error:", response.json())
        except ValueError:
            print("Error:", response.text)

cURL Command

Terminal Command

curl -X POST "https://api.pdfautoran.com/api/v1/compress" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "pdfUrl": "https://example.com/source.pdf",
    "quality": "medium",
    "fileName": "hasil-compress"
  }' \
  --output hasil-compress.pdf

💡 Tips & Best Practices

Jaga Kerahasiaan API Key

Jangan pernah commit API Key ke repository publik. Simpan di environment variables (.env).

Timeout Handling

Tambahkan timeout pada HTTP client Anda. Proses generate / compress PDF bisa butuh beberapa detik tergantung ukuran file.

Simpan PDF di Storage Anda

API mengembalikan file PDF langsung di response. Simpan ke storage/server Anda sendiri untuk penggunaan jangka panjang.

Monitoring Credits

Pantau penggunaan credits di dashboard. Setiap pemanggilan endpoint (HTML_TO_PDF, MERGE, STAMP, PDF_COMPRESS) akan mengurangi credits sesuai jenis fitur.

Contoh Penggunaan API

HTML to PDF

JavaScript (Fetch API)

Python (requests)

PHP (Guzzle)

cURL Command

Stamp PNG to PDF

JavaScript (Fetch API)

Python (requests)

Merge PDF

JavaScript (Fetch API)

cURL Command

Compress PDF

JavaScript (Fetch API)

Python (requests)

cURL Command

💡 Tips & Best Practices

Jaga Kerahasiaan API Key

Timeout Handling

Simpan PDF di Storage Anda

Monitoring Credits