Convertica API

Mengapa Convertica API

Mulai cepat

1. Terbitkan kunci di dasbor Anda

Buka dasbor Kunci API Anda dan buat kunci bernama. Kunci lengkap ditampilkan sekali — salin segera.

2. Buat permintaan

Contoh curl — konversi PDF ke Word:

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -o output.docx

Contoh Python

import requests
r = requests.post(
    "https://convertica.net/api/v1/pdf-to-word/",
    headers={"Authorization": "Bearer cvk_live_xxxxxxxxxxxxxxxx"},
    files={"pdf_file": open("input.pdf", "rb")},
)
with open("output.docx", "wb") as f:
    f.write(r.content)

Contoh Node.js

import fs from "node:fs";
import { request } from "undici";
const form = new FormData();
form.set("pdf_file", new Blob([fs.readFileSync("input.pdf")]), "input.pdf");
const r = await request("https://convertica.net/api/v1/pdf-to-word/", {
  method: "POST",
  headers: { Authorization: "Bearer cvk_live_xxxxxxxxxxxxxxxx" },
  body: form,
});
fs.writeFileSync("output.docx", Buffer.from(await r.body.arrayBuffer()));

Autentikasi

Kirim kunci API Anda sebagai token Bearer di header Authorization. Kunci terikat pada langganan Anda — cabut dan putar kapan saja dari dasbor.

• Hingga 10 kunci aktif per akun, dengan cakupan bernama opsional
• Awalan ditampilkan di dasbor untuk identifikasi mudah (kunci penuh hanya ditampilkan saat pembuatan)
• Kuota bulanan per kunci terikat pada tingkat langganan — penghitung diatur ulang pada tanggal 1
• Di-hash saat disimpan; jika kunci bocor, cabut dan terbitkan yang baru dalam hitungan detik

Webhook asinkron

Pekerjaan besar mengembalikan ID tugas dan berjalan di latar belakang. Baik polling titik akhir tugas, atau atur URL panggilan balik dan biarkan Convertica mendorong hasilnya.

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "callback_url=https://yourapp.example/convertica-hook"

Payload webhook ditandatangani dengan HMAC-SHA256 menggunakan rahasia yang ditampilkan di dasbor Anda. Verifikasi header X-Convertica-Signature sebelum mempercayai isi.

Batas dan pembatasan laju

Apa yang Anda dapatkan

• 30+ titik akhir konversi: PDF↔Word, Excel, PPT, JPG, PNG, HTML, EPUB, Markdown
• Edit PDF: gabung, pisah, putar, watermark, tanda tangan, kompres, potong, ratakan
• Gambar: optimalkan, konversi, HEIC→JPG/PNG
• Mode sinkron (file kecil) dan asinkron (file besar)
• Panggilan balik webhook bertanda HMAC opsional untuk hasil asinkron
• Dokumentasi OpenAPI 3
• Median di bawah 200ms, edge UE
• Backend yang sama dengan convertica.net — teruji di lapangan

Pertanyaan yang sering diajukan