Geliştirici Merkezi

API Dokümantasyonu

Bingo, geliştirici ergonomisi ve yapay zeka ajanları (Agentic AI) entegrasyonu hedeflenerek geliştirilmiştir. Aşağıdaki uç noktaları (endpoints) kullanarak paylaşımlarınızı programatik olarak yapabilirsiniz.

Kimlik Doğrulama (Authentication)

Tüm API uç noktaları, kişisel API anahtarınızı kullanarak kimlik doğrulaması yapmanızı gerektirir. Doğrulamayı iki yöntemden biriyle yapabilirsiniz:

  • X-API-Key istek başlığı (header) ile göndererek: 
    X-API-Key: bg_api_anahtariniz_buraya
  • Standart HTTP Bearer token yetkilendirme başlığı (header) ile göndererek: 
    Authorization: Bearer bg_api_anahtariniz_buraya
POST /api/upload

Dosya, resim veya metin yükler. Bu uç nokta üç farklı yük biçimini dinamik olarak ayrıştırabilir:

1. Multipart Dosya Yükleme

Resim, arşiv, PDF veya doğrudan kod dosyası paylaşımı için en uygun yöntemdir. Dosya, file form anahtarı altında gönderilmelidir. 

curl -X POST \
  -H "X-API-Key: bg_api_anahtariniz_buraya" \
  -F "file=@/dosya/yolu/resim.png" \
  https://bin.yigiteren.org/api/upload

2. JSON Metin Yükleme

Kod yazan veya metin çıktısı üreten yapay zeka ajanları (Agentic AI) için özel olarak optimize edilmiştir. İçerisinde text ve filename anahtarları bulunan bir JSON gövdesi gönderin. 

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bg_api_anahtariniz_buraya" \
  -d '{"text": "# Deneme Belgesi\nBingo API üzerinden merhaba!", "filename": "deneme.md"}' \
  https://bin.yigiteren.org/api/upload

3. Ham Gövde (Raw Body) Yükleme

Terminal çıktısını veya ham metin akışlarını boru hattı (pipe) ile Bingo'ya yönlendirmenizi sağlar. İçerik varsayılan olarak bir metin dosyası şeklinde kaydedilir. 

echo "Sunucu logları..." | curl -X POST \
  -H "Content-Type: text/plain" \
  -H "X-API-Key: bg_api_anahtariniz_buraya" \
  --data-binary @- \
  https://bin.yigiteren.org/api/upload

Başarılı Yanıt Şeması (JSON)

{
  "success": true,
  "filename": "resim_1.png",
  "url": "https://bin.yigiteren.org/yonetici/resim_1.png",
  "size": 14205,
  "mime_type": "image/png",
  "views": 0,
  "created_at": "2026-07-05T17:16:05Z"
}