Question 1

Apa itu ClearLogo?

Accepted Answer

ClearLogo adalah API logo yang mengembalikan gambar tunggal dan bersih untuk domain apa pun. Berbeda dengan sumber logo generik, ClearLogo fokus pada presentasi: setiap respons menyadari latar belakang, dipotong otomatis, dan sesuai rasio sehingga logo terlihat konsisten di dalam dashboard, CRM, tabel perusahaan, dan permukaan produk lainnya.

Question 2

Apakah saya perlu mendaftar untuk mencoba API?

Accepted Answer

Tidak. Anda dapat membuat permintaan anonim ke https://api.clearlogo.dev/logo/{domain} langsung untuk pengujian volume rendah — tidak diperlukan kunci. Untuk lalu lintas produksi, Anda memerlukan browser key atau server key dari dashboard.

Question 3

Apakah saya perlu server backend untuk menggunakan ClearLogo?

Accepted Answer

Tidak. Browser key memungkinkan Anda menyematkan URL logo langsung di tag <img> dari kode frontend. Permintaan divalidasi dengan mencocokkan Origin/Referer dengan domain yang diizinkan yang Anda konfigurasi pada kunci. Gunakan server key hanya ketika Anda lebih suka autentikasi Authorization: Bearer dari backend Anda.

Question 4

Dari mana saya harus memulai?

Accepted Answer

Jalur tercepat: buka playground, tempel beberapa domain representatif, dan lihat bagaimana hasil terlihat di UI Anda. Setelah Anda puas, buat production key di dashboard dan ganti URL di kode Anda.

Question 5

Apa kasus penggunaan terbaik untuk ClearLogo?

Accepted Answer

ClearLogo sangat cocok di mana pun logo berdampingan dan konsistensi visual penting — tabel perusahaan dan direktori, daftar akun CRM, UI enrichment, alat penjualan, dan dashboard internal. Jika Anda hanya membutuhkan satu logo di balik cache sisi server dan konsistensi presentasi bukan masalah, sumber generik mungkin sudah cukup.

Question 6

Apa perbedaan antara browser key dan server key?

Accepted Answer

A browser key (pk_…) aman untuk dikirim di kode frontend dan tag <img>. Permintaan diautentikasi dengan mencocokkan header Origin atau Referer dengan domain yang diizinkan yang Anda konfigurasi. A server key (sk_…) mengautentikasi melalui Authorization: Bearer YOUR_KEY dari backend Anda dan tidak boleh pernah diekspos ke browser.

Question 7

Bagaimana cara membatasi browser key saya ke domain tertentu?

Accepted Answer

Di dashboard, buka pengaturan kunci, aktifkan Allowed Domains Only, dan tambahkan domain Anda satu per baris. Notasi wildcard seperti *.example.com didukung untuk subdomain.

Question 8

Apa yang terjadi pada permintaan tanpa header Referer setelah saya mengaktifkan pembatasan domain?

Accepted Answer

Permintaan akan diblokir. Lalu lintas langsung dan permintaan yang dikirim dengan Referrer-Policy: no-referrer atau same-origin akan gagal setelah pembatasan domain diaktifkan. Kebijakan yang berfungsi termasuk strict-origin-when-cross-origin, origin, origin-when-cross-origin, dan unsafe-url. Anda dapat memverifikasi pengaturan dengan memeriksa header Referer pada permintaan img.logo.dev di tab Network browser Anda sebelum mengaktifkan pembatasan.

Question 9

Bagaimana cara merotasi atau mengganti kunci API?

Accepted Answer

Buat kunci baru di dashboard, perbarui integrasi Anda untuk menggunakannya, lalu hapus kunci lama. Jika Anda memerlukan rotasi mendesak, hubungi support@clearlogo.dev.

Question 10

Format gambar apa yang dikembalikan ClearLogo?

Accepted Answer

png adalah default. Anda dapat meminta webp atau jpeg melalui parameter query format. Ketika format dihilangkan, API melakukan negosiasi konten dari header permintaan Accept — browser modern yang memuat melalui <img> menerima WebP secara otomatis.

Question 11

Apa maksud output "background-aware"?

Accepted Answer

ClearLogo mendeteksi apakah logo merek dirancang untuk latar belakang berwarna atau gelap dan mempertahankan latar belakang itu dalam gambar respons. Ini mencegah masalah umum logo transparan yang terlihat rusak di permukaan terang.

Question 12

Ukuran apa yang tersedia?

Accepted Answer

Parameter size menerima pangkat dua: 16, 32, 48, 64, 96, 128, 192, 256, 512, dan 1024 piksel. Gambar selalu persegi. Default adalah 128 px. Nilai di luar daftar ini otomatis diarahkan ke ukuran yang diizinkan terdekat (jika sama jaraknya, nilai yang lebih besar dipilih).

Question 13

Apa yang dilakukan parameter `theme`?

Accepted Answer

Mengatur theme=dark mengembalikan varian latar belakang gelap dari logo ketika tersedia. Jika tidak ada varian gelap, API kembali ke versi standar.

Question 14

Apa batas lajunya?

Accepted Answer

Batas bervariasi menurut paket — lihat halaman harga untuk detail. Penggunaan per-kunci dikembalikan di header respons X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset sehingga Anda dapat memantau konsumsi secara real time.

Question 15

Apa yang terjadi ketika saya melampaui batas laju saya?

Accepted Answer

API mengembalikan HTTP 429 dengan header Retry-After yang menunjukkan berapa detik untuk menunggu sebelum mencoba ulang. Kami akan menghubungi Anda sebelum mengambil tindakan lebih lanjut — layanan tidak dipotong tanpa peringatan.

Question 16

Bagaimana cara memeriksa penggunaan saat ini saya?

Accepted Answer

Penggunaan real-time terlihat di dashboard. Anda juga dapat membaca header X-RateLimit-Remaining pada respons API apa pun.

Question 17

Logo tidak ditampilkan untuk domain — apa yang harus diperiksa?

Accepted Answer

Kerjakan daftar periksa ini: (1) konfirmasi domain adalah hostname telanjang tanpa skema atau jalur, mis. github.com bukan https://github.com/; (2) periksa bahwa kunci API Anda valid dan tidak kadaluarsa; (3) jika pembatasan domain diaktifkan, verifikasi header Referer sedang dikirim; (4) periksa kode status respons — 404 berarti tidak ada logo yang ditemukan untuk domain itu, 401 berarti masalah auth, 429 berarti rate limited.

Question 18

Logo untuk domain terlihat salah atau ketinggalan zaman — apa yang bisa saya lakukan?

Accepted Answer

Hubungi kami di support@clearlogo.dev dengan nama domain dan catatan tentang apa yang terlihat tidak benar. Kami akan meninjau dan memperbarui aset.

Question 19

Saya mendapatkan kesalahan 401 — apa artinya?

Accepted Answer

A 401 berarti permintaan tidak diautentikasi. Untuk browser key, pastikan parameter query token disertakan dan header Origin/Referer cocok dengan domain yang diizinkan. Untuk server key, pastikan header Authorization: Bearer YOUR_KEY ada dan kunci belum dihapus.

Question 20

Logo memuat dalam produksi tetapi tidak selama pengembangan lokal — bagaimana cara memperbaikinya?

Accepted Answer

Tambahkan localhost (atau localhost:3000, localhost:5173, dll.) ke domain yang diizinkan kunci Anda di dashboard. API cocok dengan asal yang tepat, jadi sertakan port jika server dev Anda menggunakan yang non-standar. Hapus entri lokal sebelum mendistribusikan kunci, atau buat kunci pengembangan terpisah.

Question 21

Saya melihat kesalahan CORS di browser — bagaimana cara memperbaikinya?

Accepted Answer

API menetapkan header CORS yang permisif, jadi kesalahan CORS biasanya menunjukkan header Referer yang hilang atau diblokir daripada masalah CORS sejati. Periksa Referrer-Policy halaman Anda — kebijakan seperti no-referrer mencegah header Referer dikirim, yang akan menyebabkan permintaan gagal ketika pembatasan domain aktif. Juga periksa tag <img> itu sendiri: atribut referrerpolicy="no-referrer" atau referrerpolicy="same-origin" pada elemen menggantikan kebijakan tingkat halaman dan menghapus Referer dari permintaan spesifik itu.

Question 22

Paket apa yang tersedia?

Accepted Answer

ClearLogo menawarkan paket gratis untuk penggunaan volume rendah dan paket berbayar untuk lalu lintas produksi. Lihat halaman harga untuk detail paket saat ini dan batas permintaan.

Question 23

Bagaimana cara meningkatkan paket saya?

Accepted Answer

Kunjungi dashboard dan pilih Upgrade dari kartu paket Anda. Anda akan dibawa ke halaman penagihan di mana Anda dapat memilih paket dan menyelesaikan pembayaran.

Question 24

Bisakah saya membatalkan langganan saya?

Accepted Answer

Ya. Anda dapat membatalkan kapan saja dari dashboard. Paket Anda tetap aktif hingga akhir periode penagihan saat ini.

Bantuan & FAQ

Memulai

Kunci API & Autentikasi

Output & Pemformatan

Batas Laju & Penggunaan

Pemecahan Masalah

Tagihan & Paket

Masih punya pertanyaan?