> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV formatı

> Toplu oluşturma için CSV dosyasını hazırlama: zorunlu başlık, satırlar, URL kuralları ve doğrulama hataları.

Toplu oluşturma basit bir CSV dosyasını okur: bir başlık satırı, ardından her QR kod için bir ad ve hedef URL içeren bir satır. Bu sayfa, dosyayı yüklediğinizde GetQR'ın kontrol ettiği kuralları listeler.

## Örnek dosya

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

Bu başlangıç dosyasını uygulamadan da indirebilirsiniz: **Add links** adımında **Download CSV template** öğesine tıklayın.

## Kurallar

| Bölüm | Kural |
| - | - |
| Dosya | `.csv` dosyası olmalıdır. Excel ve diğer formatlar kabul edilmez. |
| Başlık | İlk satır tam olarak `name,url` olmalıdır: küçük harfle, bu sırayla, başka sütun olmadan. |
| Satırlar | En fazla 100 boş olmayan satır. Boş satırlar yok sayılır. |
| `name` | Zorunlu. QR kodun adı olur. En fazla 40 karakter; daha uzun adlar 40 karaktere kısaltılır. |
| `url` | Zorunlu. `http://` veya `https://` ile başlayan bir web adresi. |

### URL kuralları

* Şemayı yazmazsanız GetQR `https://` ekler. `example.com/menu`, `https://example.com/menu` olur.
* Adres, `example.com` gibi nokta içeren gerçek bir alan adı içermelidir.
* Boşluk, sekme veya satır sonu olmamalıdır.
* Yalnızca web bağlantıları çalışır. `mailto:`, `ftp://`, `javascript:` ve düz e-posta adresleri reddedilir.

### Yinelenen adlar

Adların benzersiz olması gerekmez. İki satır aynı ada sahipse (büyük/küçük harf farkı gözetilmeden), GetQR tekrarları numaralandırır: `Menu`, `Menu 2`, `Menu 3`.

### Virgüller ve tırnak işaretleri

Bir ad virgül içeriyorsa `"Downtown, Main St"` örneğindeki gibi çift tırnak içine alın. Elektronik tablo uygulamaları CSV olarak kaydederken bunu sizin için yapar.

## Dosyayı elektronik tabloda oluşturma

**1. İki sütun ayarlayın**

İlk satırda A sütununa `name`, B sütununa `url` yazın.

**2. Her kod için bir satır ekleyin**

Her satıra bir ad ve bir bağlantı girin; en fazla 100 satır.

**3. CSV olarak kaydedin**

Sayfayı CSV olarak dışa aktarın veya kaydedin. Excel'de **CSV UTF-8** seçin. Google Sheets'te **File > Download > Comma-separated values** seçin.

> [!TIP]
>
> UTF-8 olarak kaydetmek, adlarınızdaki aksanlı harfleri ve İngilizce dışındaki diğer karakterleri (ör. ç, ğ, ı, ş) korur.

## Doğrulama hataları

### Dosya hataları

Bunlar dosyanın tamamını durdurur. Dosyayı düzeltip yeniden yükleyin.

| Mesaj | Yapmanız gereken |
| - | - |
| Choose a CSV file. Other file types are not supported. | Dosyayı `.xlsx` veya `.numbers` olarak değil, `.csv` olarak kaydedin. |
| The CSV header must be exactly name,url in that order. | İlk satırı tam olarak `name,url` yapın. Büyük harfleri, fazladan sütunları veya eksik başlığı kontrol edin. |
| Add at least one non-empty data row to the CSV. | Dosyada başlık var ama satır yok. En az bir ad ve bağlantı ekleyin. |
| A CSV can contain at most 100 non-empty rows. | Listeyi en fazla 100 satırlık dosyalara bölün. |
| This CSV is malformed and could not be read. | Dosyayı elektronik tablo uygulamanızdan yeniden dışa aktarın. Kapatılmamış tırnak işaretlerini arayın. |

### Satır hataları

Bunlar tek tek satırları işaretler. Düzeltip yeniden yükleyebilir veya yalnızca geçerli satırlarla devam edebilirsiniz.

| Rozet veya mesaj | Neden |
| - | - |
| **MISSING** / Name is required | `name` hücresi boş. |
| **MISSING** / URL is required | `url` hücresi boş. |
| **INVALID** / Enter a valid HTTP(S) URL | Bağlantı [URL kurallarından](#url-rules) birini ihlal ediyor. |

Satır numaraları başlığı 1. satır olarak sayar; bu nedenle ilk veri satırı, elektronik tablonuzda olduğu gibi 2. satırdır.

## Sık karşılaşılan sorunlar

> **Başlığım doğru görünüyor ama yine de başlık hatası alıyorum**
>
> Başlık küçük harfle yazılmalı ve yalnızca iki sütun içermelidir. `Name,URL` veya `name,url,notes` başarısız olur. Elektronik tablonuzda `url` sütununun sağında boş sütunlar olup olmadığını da kontrol edin.

> **Tarayıcımda çalışan bir bağlantı INVALID olarak işaretlendi**
>
> Bağlantı bir boşluk içeriyor veya http ya da https dışında bir şema kullanıyor olabilir. Boşlukları `%20` olarak kodlayın veya kaldırın ve tam bir web adresi kullanın.

> **Bazı adlar kısaltıldı**
>
> 40 karakterden uzun adlar 40 karaktere kısaltılır. İfadeyi kendiniz seçmek istiyorsanız dosyada kısaltın.

## Sırada ne var

> **[CSV'den QR kod oluşturma](/tr/bulk/create-from-csv)**
>
> Dosyanızı yükleyin ve grubu başlatın.

> **[Toplu oluşturmaya genel bakış](/tr/bulk/overview)**
>
> Sınırlar ve toplu oluşturmanın nasıl çalıştığı.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.