API anahtarı oluşturma ve güvenle yönetme: okuma, yazma, iptal

API anahtarı nedir

API anahtarı, bir programın bir hizmete kendini tanıtmak için kullandığı uzun, rastgele bir karakter dizisidir. Onu bilen herkes, anahtarın izin verdiği her şeyi yapabilir. Bu yüzden API anahtarı tıpkı bir parola gibi güvenle saklanmalıdır. Same-QR'da onu sameqr komut satırı için, REST API üzerindeki kendi komut dosyaların için ve Claude Code, Cursor ve Codex gibi kodlama ajanları için kullanırsın. ChatGPT ve Claude.ai'ye gerek yok, onlar OAuth ile giriş yapar.

Adım 1: Doğru yeri bul

Panele giriş yap ve Hesap'ı aç. Orada “CLI, komut dosyaları ve ajanlar için erişim“ bölümü var. Anahtarlar yalnızca burada, tarayıcıda oturum açılarak oluşturulabilir. Bir anahtar başka anahtar üretemez, böylece çalınan bir anahtar çoğalmaz.

Adım 2: Yetkileri seç

Üç düzey var. Her zaman görev için yeten en küçüğünü seç.

• Tarama raporları, analizler, yalnızca soruları yanıtlayan bir asistan: salt okunur.
• QR kodları ve sayfaları oluşturan, adları ve metinleri değiştiren, yayımlayan, menüleri içe aktaran komut dosyaları: okuma + yazma.
• Mevcut QR kodların hedeflerini değiştiren, sayfaları çevrimdışı yapan veya silen akışlar: tam. Böyle her değişiklik okunan durumla bir onay gerektirir, API üzerinden saatte en fazla 10 ve günde 30 yapılabilir.

Okuma anahtarıyla değiştiren her istek reddedilir. MCP üzerinden okuma anahtarıyla bağlanan bir kodlama ajanı, yazan araçları hiç görmez.

Adım 3: Süre ve ad

Her anahtarın süresi dolar: 30, 90, 180 veya 365 gün sonra, varsayılan 90'dır. Süresiz de olur, ama bunu bilerek seçmen gerekir, örneğin onu yenileyen bir insanın olmadığı gece işi için. Anahtara amacına göre bir ad ver, örneğin “A müşterisi aylık rapor“. Hesap başına en fazla 10 anahtar mümkün.

Adım 4: Hemen güvenle sakla

Anahtar sqr_live_ ile başlar ve tam bir kez gösterilir. Same-QR yalnızca bir sağlama toplamı saklar ve onu sana sonradan bir daha gösteremez. Doğrudan parola yöneticine koy. Programlar onu başlangıçta SAMEQR_API_KEY ortam değişkeninden okur. Bir anahtarın yeri şurası değildir:

• kaynak kod, hele ki herkese açık bir depo,
• bir adres, çünkü adresler kayıtlara ve geçmişlere düşer,
• bir tablo, e-posta veya sohbet mesajı,
• bir yapay zekâ asistanıyla yapılan sohbet,
• bir komutta argüman olarak, çünkü o zaman kabuk geçmişinde görünür.

Sabit başlangıç sqr_live_ bir amaca hizmet eder: yanlışlıkla yayımlanmış sırları arayan araçlar anahtarı bundan tanır.

Adım 5: Gerekirse iptal et

Aynı listede bir anahtarı tek tıkla iptal edersin. Anında geçersiz olur, QR kodların değişmeden kalır. Süresi dolmuş anahtarlar notla birlikte listede kalır, böylece bir komut dosyasının neden aniden geçemediğini görürsün. Parola değişikliği ayrıca tüm anahtarları tek seferde iptal eder. Anahtar bir yerde görünür hale geldiyse, bir hizmet sağlayıcı artık senin için çalışmıyorsa veya ne için olduğunu artık bilmiyorsan anahtarı iptal et.

Sonuç: Neden Same-QR

Same-QR anahtarları ciddiye alır: ayrı yetkiler, mantıklı varsayılanlı süreler, yalnızca tek bir kez gösterme, yalnızca sağlama toplamı olarak saklama ve anında etkili iptal. Böylece API'yi, CLI'yi ve kodlama ajanlarını her tarifede rahatça kullanabilirsin.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, dokümantasyon sameqr.com/entwickler adresinde.

Sık sorulan sorular