Uçlar 2xx dönüyor, rozet profile gidiyor, liste yükleniyor mu? Takılırsanız teknik destek formunu doldurun.
İlerleme bu tarayıcıda yerel olarak saklanır; sunucuya gönderilmez.
Herkese açık API (v1)
STK’ları, etkinlikleri, gönüllülük ilanlarını, açık fon çağrılarını, hangel Market’i ve kütüphaneyi kendi sitenize, uygulamanıza ya da yapay zekâ asistanınıza taşıyın. Yalnız sayfalarımızda zaten herkese açık olan bilgiler verilir.
Örnek istek
$ curl "https://hangel.org/api/v1/volunteering?city=izmir&limit=5"
200 OK · application/json
Ayrıntılar: Herkese açık API (v1)
Yanıtlar JSON biçimindedir. Her kayıtta kalıcı sayfa adresi, güncellenme zamanı, içeriğin dili ve çeviri durumu bulunur.
Giriş yapmış kullanıcı ya da kurum yöneticisi adına çalışır (Streamable HTTP, durumsuz). OAuth 2.1 erişim belirteci ya da kişisel erişim anahtarı ister; kimliksiz istek 401 ve OAuth keşif başlığı döner.
Herkese açık API ve herkese açık MCP sunucusu anahtarsızdır. Kullanıcı ya da kurum adına işlem yapan uç (/api/mcp/me) iki kimlik türünden birini kabul eder.
Anahtarsız
/api/v1 ve /api/mcp: salt okur, yalnız herkese açık veri, kişisel veri yok.
Kişisel erişim anahtarı
Authorization: Bearer hgl_pat_…. Anahtar Projeni Yaz › Bağlantı sayfasında oluşturulur ve iptal edilir; sunucuda yalnız özeti saklanır.
OAuth 2.1 erişim belirteci
Authorization: Bearer hgl_oat_…. ChatGPT uygulaması ve Claude bağlayıcısı bu yolla bağlanır.
Yetkilendirme kodu akışı; PKCE S256 zorunlu. İstemci kimlik doğrulaması yok (herkese açık istemci, token_endpoint_auth_method: none).
İstemci kaydı: chatgpt.com, claude.ai ve claude.com için istemci kimliği meta veri belgesi (CIMD); diğer istemciler dinamik kayıtla (DCR) gelir.
Dönüş adresi https olmalı; yerel döngü (127.0.0.1, localhost, [::1]) için http de kabul edilir. Adreste parça (#) ve kullanıcı bilgisi olamaz.
resource parametresi (RFC 8707) belirtecin hedefini belirler: hangel.org, /api/mcp, /api/mcp/chatgpt ya da /api/mcp/me. Yanıtlarda RFC 9207 iss parametresi döner.
Belirteçler opaktır (JWT değil). Erişim belirteci 1 saat, yenileme belirteci 30 gün geçerlidir ve her kullanımda döner; yetkilendirme kodu 5 dakika, tek kullanımlıktır.
Kapsamlar (scope)
Her araç tek kapsam ister; belirtecte yoksa araç insufficient_scope döner. Yazma kapsamları kullanıcı adına değişiklik yapar ve her işlem iki adımlı onayla çalışır. Ödeme hiçbir zaman yapay zekâdan yapılmaz.
drafts:readTür: Okuma
Projeni Yaz taslaklarımı okuma
account:readTür: Okuma
Başvurularımı, etkinlik kayıtlarımı, sertifikalarımı ve tercihlerimi okuma
volunteer:applyTür: Yazma
Gönüllülük ilanlarına benim adıma başvurma
events:rsvpTür: Yazma
Etkinliklere benim adıma katılma ve katılımımı iptal etme
follows:writeTür: Yazma
STK takip etme, takibi bırakma ve ilan kaydetme
profile:writeTür: Yazma
Profil tercihlerimi, desteklediğim STK seçimimi ve kan bağışı ayarlarımı güncelleme
emergency:respondTür: Yazma
Açık kan ihtiyacına benim adıma "Gelebilirim" yanıtı verme
drafts:writeTür: Yazma
Projeni Yaz taslağı oluşturma ve güncelleme (silme yok)
feedback:writeTür: Yazma
Katıldığım etkinliği benim adıma değerlendirme
org:readTür: Okuma
Yönettiğim kurumların etkinlik, ilan, başvuru, katılımcı ve rapor bilgilerini okuma
org:draftTür: Yazma
Yönettiğim kurumlar için taslak hazırlama (yayın ve gönderim panelde benim onayımla)
market:readTür: Okuma
hangel Market'te ürün arama ve karşılaştırma, bağış tahmini; favorilerimi, fiyat alarmlarımı ve alışverişten bağışlarımı okuma
market:writeTür: Yazma
hangel Market favorilerime ve fiyat alarmlarıma ürün ekleme ve çıkarma; bağış izli mağaza bağlantısı hazırlama (ödemeyi her zaman ben yaparım)
Gömme kodları ve araçlar
Kurumlar bu parçaları kendi sitelerine yapıştırır. Hepsi herkese açık adreslerden çalışır; anahtar gerekmez. Burada gördüğünüz kodlar, kurum panelindeki üreticilerle aynı koddan çıkar.
Kurum kimliği
Boş bırakırsanız kodlarda YOUR_ORG_ID yer tutucusu görünür.
Ayrıntılar: Kurum kimliği
Kimlik, herkese açık profil adresinin son parçasıdır: hangel.org/ngos/{orgId}, /market/{orgId} ya da /clubs/profile/{orgId}. Panelde “Paylaşım bağlantıları” sayfasındaki “Sitene ekle” bölümü kimliği hazır doldurur.
iframe ve içeriğe göre yüksekliği ayarlayan kısa bir betik. Yalnız herkese açık etkinlik ve ilanlar görünür; sayfa 5 dakika önbelleğe alınır. Betik yoksa yalnız iframe satırı da çalışır.
yt=1: organizatör YouTube yayını verdiyse oynatıcı YouTube’u kullanır.
lang: arayüz dili (varsayılan tr).
İzlenen paylaşım bağlantısı
Herhangi bir hangel etkinlik ya da ilan adresine ?ref=<kod> ekleyin; bağlantıdan gelen tıklama, kayıt ve katılım panelde sayılır. Kod panelde oluşturulur ve kuruma özeldir.
42 program otomatik bağlanıyor. 59 program yarı otomatik: Excel/CSV, takvim aboneliği ya da veri akışıyla. 39 program elle bağlanıyor ya da hiç bağlantı yok. Bunların 7’si kurmaya değmez.
hangel Afet Telsizi açık kaynaktır (Apache-2.0). İnternet ve mobil şebeke yokken yakındaki telefonlar Bluetooth ve eşler arası Wi-Fi üzerinden sesli mesaj, kısa mesaj ve yardım çağrısı paylaşır. 112’nin yerine geçmez.
16 sektörde 140 program: İK, STK, etkinlik, e-ticaret, muhasebe, CRM, web ve yapay zekâ. Programı ara, sektöre göre süz; her biri için bağlantı düzeyini ve hangel tarafındaki yapı taşını gör.