# Mulai cepat

Jalankan panggilan API pertama dan unduh file Excel.

Dokumentasi resmi: https://img2excel.net/id/docs/api/getting-started

API IMG2Excel mengubah gambar tabel menjadi buku kerja Excel yang dapat diedit. Kami menyarankan endpoint sinkron: unggah gambar, tunggu konversi selesai, lalu unduh XLSX dari URL yang dikembalikan. Endpoint asinkron tetap tersedia.

| Parameter | Nilai |
| --- | --- |
| URL dasar | `https://img2excel.net` |
| Autentikasi | `Authorization: Bearer $IMG2EXCEL_API_KEY` |
| Akses API | Paket kredit Business atau Professional |
| Input | Satu gambar PNG, JPG, atau JPEG, maksimal 4 MB |
| Output | File `.xlsx` yang dapat diedit |

## 1. Atur kunci API

Salin kunci dari [pengaturan API](https://img2excel.net/id/settings/api) dan simpan dalam variabel lingkungan di server:

```bash
export IMG2EXCEL_API_KEY="your_api_key"
```

Jaga kerahasiaan kunci. Jangan masukkan ke kode browser atau repositori publik.

## 2. Unggah gambar tabel

Pilih endpoint yang sesuai dengan gambar:

| Gambar | Endpoint |
| --- | --- |
| Tabel cetak, tangkapan layar, atau lembar kerja hasil pemindaian | [Gambar ke Excel](https://img2excel.net/id/docs/api/image-to-excel) |
| Tabel, jurnal, atau catatan tulisan tangan | [Tulisan tangan ke Excel](https://img2excel.net/id/docs/api/handwriting-to-excel) |

Contoh berikut mengirim tabel cetak. Ganti `table.png` dengan lokasi gambar Anda. Untuk tulisan tangan, gunakan `/api/v1/handwriting-to-excel`.

```bash
curl --fail-with-body --max-time 330 -i https://img2excel.net/api/v1/image-to-excel \
  -H "Authorization: Bearer $IMG2EXCEL_API_KEY" \
  -H "Idempotency-Key: table-import-001" \
  -F "file=@table.png"
```

Gunakan `Idempotency-Key` yang berbeda untuk setiap gambar baru. Gunakan kembali nilainya hanya untuk mengulang unggahan yang sama.

Permintaan sinkron mengembalikan **200 OK** setelah selesai, beserta `result.download_url`. URL berikut hanya contoh; gunakan URL dari respons Anda.

```json
{
  "id": "job_0123456789abcdef0123456789abcdef",
  "type": "image-to-excel",
  "status": "succeeded",
  "credits_reserved": 1,
  "credits_used": 1,
  "created_at": "2026-10-04T09:00:00.000Z",
  "completed_at": "2026-10-04T09:00:08.000Z",
  "result": {
    "filename": "table_result.xlsx",
    "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "size_bytes": 17330,
    "download_url": "https://signed-storage-url.example/...",
    "download_url_expires_in": 900
  }
}
```

Endpoint sinkron menunggu konversi selesai. Atur batas waktu klien HTTP menjadi 330 detik. Jika koneksi kehabisan waktu, ulangi dengan `Idempotency-Key` yang sama. Kunci baru memulai konversi baru.

## 3. Unduh file Excel

Salin `result.download_url` dari respons yang berhasil:

```bash
curl --fail --location "PASTE_RESULT_DOWNLOAD_URL_HERE" --output table.xlsx
```

URL unduhan berlaku selama 15 menit. Hasil disimpan selama 24 jam setelah selesai. Ambil kembali tugas dalam periode tersebut untuk memperoleh URL baru. Konversi yang gagal tidak menggunakan kredit.

## Konversi asinkron (opsional)

Untuk pemrosesan latar belakang, tambahkan `/jobs` ke endpoint. Tugas baru mengembalikan `202`, ID, dan header `Location`. Periksa URL tersebut setiap 2–3 detik hingga status `succeeded`, `failed`, atau `expired`. Skrip polling tersedia di [Tugas dan kesalahan](https://img2excel.net/id/docs/api/jobs).

Konversi sinkron yang gagal mengembalikan `422`, `error.code`, dan `error.message`. Pengulangan dengan kunci idempotensi yang sama mengembalikan tugas awal. Jika masih berjalan, responsnya `202`; periksa URL `Location`. Hasil kedaluwarsa mengembalikan `410`.

## Gunakan asisten pemrograman AI

Pilih **Salin untuk AI** di atas lalu tempelkan petunjuk ke ChatGPT, Claude, Gemini, Cursor, atau asisten lainnya. Sebutkan bahasa pemrograman server dan jenis tabel: cetak atau tulisan tangan. Setiap halaman endpoint juga menyediakan fitur salin serta contoh Python / Node.js.

Lihat [spesifikasi OpenAPI](https://img2excel.net/api/openapi.json) atau [dokumentasi API lengkap](https://img2excel.net/id/docs/api/text/llms-full.txt) untuk definisi API secara menyeluruh.

---

OpenAPI 3.1: https://img2excel.net/api/openapi.json
Dokumentasi API lengkap: https://img2excel.net/id/docs/api/text/llms-full.txt