Ana içeriğe atla

Geliştiriciler

hangel’ı kendi yazılımınıza bağlayın

Yapay zekâ asistanı, web sitesi ya da uygulama: hepsi hangel’a kolayca bağlanır.

  • Ücretsiz
  • Anahtar gerekmez
  • Salt okur
  • Kişisel veri yok
  1. Kullanıcı
  2. Yapay zekâ
  3. hangel
  4. STK
Kullanıcı sorar, yapay zekâ hangel’dan güncel ilanları getirir, kullanıcı STK’ya ulaşır.
  • ClaudeGeminiModel Context Protocol

    Claude, ChatGPT ve Gemini hangel’daki etkinlik, ilan ve fonları bulur.

  • WordPressSquarespace

    Üye rozeti, etkinlik listesi ve canlı yayın tek satır kodla sitende.

  • OAuthAirtablePersonio

    Veriyi anahtarsız REST API ile çek, olayları imzalı webhook ile al.

  • MeetupTelegramPerplexity

    140 programın hangel ile nasıl bağlandığını karşılaştır.

Hızlı başlangıç kontrol listesi

Hangi kurum türü için geliştirdiğinizi seçin; entegrasyon adımlarını sırayla işaretleyin. İlerleme yalnız bu tarayıcıda saklanır.

Şunun için geliştiriyorum

0 / 10 adım tamamlandı

  1. Kurum hesabını oluştur
  2. Kurum kimliğini (orgId) bul
  3. Üye rozetini ekle
  4. Etkinlik ve ilan listesini göm
  5. Takvim akışına abone ol (iCal)
  6. RSS / JSON Feed akışını bağla
  7. İmzalı webhook’u kur
  8. CSV / Excel aktarımını kur
  9. Yapay zekâ uygulamasını OAuth ile bağla
  10. Doğrula; sorun varsa bildir

İ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.

Temel adres

https://hangel.org/api/v1

Kaynaklar

Nasıl çalışır

  • Sayfalama imleçlidir: limit ve cursor. Sonraki sayfanın imleci pagination.nextCursor alanında ve Link başlığında gelir.
  • Süzme ve arama: q, city, category, from, to, language. Sıralama: sort; baştaki "-" azalan sıra demektir.
  • Hatalar RFC 9457 biçimindedir (application/problem+json).
  • Oran sınırı istemci başına dakikada 120 istektir, ürün aramasında 30. Sınır aşılınca 429 ve Retry-After döner.
  • Önbellek: ETag ve If-None-Match desteklenir. Yanıtlar en çok 5 dakika önbellekte kalır.
  • Süresi dolan etkinlik ve çağrılar listelenmez ya da expired: true ile işaretlenir.

OpenAPI 3.1 belgesi

Bütün uçlar, parametreler ve yanıt şemaları makine-okur belgede yer alır. Kod üreticileri, Postman ve yapay zekâ araçları bu belgeyi doğrudan okur.

https://hangel.org/api/v1/openapi.json

openapi.json’u aç

MCP sunucusu (yapay zekâ bağlayıcısı)

Model Context Protocol ile Claude, ChatGPT, Gemini ve diğer yapay zekâ asistanları hangel’ı salt okur araçlarla sorgular. Anahtar gerekmez.

Sunucu adresi

https://hangel.org/api/mcp
Ayrıntılar: MCP sunucusu (yapay zekâ bağlayıcısı)

ChatGPT için adres

https://hangel.org/api/mcp/chatgpt

Sunucu kartı

Kişisel MCP sunucusu

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.

Kişisel sunucu adresi

https://hangel.org/api/mcp/me

Erişim anahtarı oluştur

Kimlik doğrulama ve OAuth 2.1

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.

Ayrıntılar: Kimlik doğrulama ve OAuth 2.1

Uç noktalar ve keşif belgeleri

Akış kuralları

  • 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.

Paylaşım bağlantıları (panel)

Kodda YOUR_ORG_ID, YOUR_EVENT_ID, YOUR_LISTING_ID ve YOUR_REF_CODE yer tutucularını kendi değerlerinizle değiştirin.

Üye rozeti (“hangel üyesidir”)

Sitenize tek satır HTML olarak eklenir; rozet kurumun hangel profiline bağlanır. Web için SVG, e-posta imzası için PNG. JavaScript ve çerez kullanmaz.

Önizleme

hangel üyesidir

Gömme kodu

<a href="https://hangel.org/uye/stk/YOUR_ORG_ID" target="_blank" rel="noopener"><img src="https://hangel.org/api/rozet?tur=genel&amp;tema=acik&amp;boyut=m&amp;dil=tr" alt="hangel üyesidir" width="160" height="60" style="border:0"></a>
Ayrıntılar: Üye rozeti (“hangel üyesidir”)

Parametreler

  • tur: Rozet türü — genel, stk, marka ya da kulup.
  • tema: Renk — acik, koyu ya da mercan.
  • boyut: Boyut — s (120 px), m (160 px) ya da l (224 px); en-boy oranı 8:3.
  • dil: Rozet metninin dili — 12 site dili (tr, en, ru, ar, fa, es, ha, de, hu, fr, az, da).
  • format: Çıktı biçimi — svg (varsayılan) ya da png.

Tam rozet oluşturucu ve kullanım kuralları

Etkinlik ve gönüllülük listesi

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.

Ayrıntılar: Etkinlik ve gönüllülük listesi

Gömme kodu

<iframe id="hangel-all-YOUR_ORG_ID" src="https://hangel.org/api/public/org/YOUR_ORG_ID/embed?lang=tr" title="Etkinlikler · Gönüllülük" width="100%" height="600" loading="lazy" style="border:0;border-radius:16px;width:100%"></iframe> <script>window.addEventListener('message',function(e){var f=document.getElementById('hangel-all-YOUR_ORG_ID');if(f&&e.source===f.contentWindow&&e.data&&e.data.type==='hangel-embed-height'&&e.data.height>0){f.style.height=Math.ceil(e.data.height)+'px'}});</script>

Koddaki kısa betik, çerçevenin yüksekliğini listeye göre ayarlar. Siteniz betiğe izin vermiyorsa yalnız ilk satır (iframe) da çalışır.

Önizleme

Canlı önizleme için yukarıya kurum kimliğinizi yazın.

Parametreler

  • show: Liste — all (varsayılan), events ya da volunteering.
  • lang: Liste dili — 12 site dili; ar ve fa sağdan sola çizilir.
  • compact=1: tek kurumun sayfasında tekrar eden kurum satırını gizler.

Tek etkinlik ya da ilan

Aynı gömme, tek kayda daraltılmış hâli. Kayıt kimliği, etkinlik ya da ilan sayfasının adresindeki kimliktir; panel de kodu hazır verir.

Ayrıntılar: Tek etkinlik ya da ilan

Gömme kodu · Yalnız etkinlikler

<iframe src="https://hangel.org/api/public/events/YOUR_ORG_ID/embed?event=YOUR_EVENT_ID" width="100%" height="600" style="border:0;border-radius:16px" loading="lazy" title="Etkinlikler"></iframe>

Gömme kodu · Yalnız gönüllülük ilanları

<iframe src="https://hangel.org/api/public/volunteering/YOUR_ORG_ID/embed?listing=YOUR_LISTING_ID" width="100%" height="600" style="border:0;border-radius:16px" loading="lazy" title="Gönüllülük"></iframe>

Parametreler

  • event: yalnız bu etkinliği göster (etkinlik gömmesinde).
  • listing: yalnız bu gönüllülük ilanını göster (ilan gömmesinde).
  • lang: Liste dili — 12 site dili; ar ve fa sağdan sola çizilir.
  • compact=1: tek kurumun sayfasında tekrar eden kurum satırını gizler.

Canlı yayın oynatıcısı (Saye)

Organizatör ilanda canlı yayını web’e açtıysa oynatıcı siteye gömülür. Giriş gerekmez; izleyici yalnız izler ve odada gizli katılımcıdır.

Ayrıntılar: Canlı yayın oynatıcısı (Saye)

Gömme kodu

<iframe src="https://hangel.org/saye/embed/event/YOUR_EVENT_ID" width="100%" style="aspect-ratio:16/9;border:0;border-radius:16px" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen loading="lazy" title="hangel"></iframe>

Parametreler

  • 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.

Ayrıntılar: İzlenen paylaşım bağlantısı

Gömme kodu

https://hangel.org/event/YOUR_EVENT_ID?ref=YOUR_REF_CODE

Parametreler

  • ref: kurumun paylaşım kodu (6–10 karakter). Kişisel veri taşımaz.

Kodu panelde oluştur

Entegrasyon dizini

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.

Ayrıntılar: Herkesi bir anda kapsayan yapı taşları

Akışlar: RSS ve JSON Feed

Yeni etkinlikleri, ilanları ve duyuruları akış okuyucunuzla ya da kendi sitenizde izleyin.

Ayrıntılar: Akışlar: RSS ve JSON Feed

Kurum akışları

Her STK’nın kendi ilan akışı ve takvimi vardır. {id} yerine STK kimliğini yazın; kimlik, STK profil adresinin sonundaki koddur.

  • Gönüllülük ilanları · RSShttps://hangel.org/api/public/volunteering/{id}/rss
  • Gönüllülük ilanları · JSON Feedhttps://hangel.org/api/public/volunteering/{id}/feed.json
  • Takvim (ICS)https://hangel.org/takvim/kurum/{id}.ics

llms.txt

Yapay zekâ arama araçları için hangel’ı anlatan kısa ve uzun metin dosyaları.

Açık kaynak

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.

GitHub deposu

https://github.com/hangelapp/hangel-disaster-walkie-talkie

Sınırlar ve kotalar

Sınırlar sunucuda uygulanır; aşıldığında 429 ve Retry-After döner.

Ayrıntılar: Sınırlar ve kotalar
Sınırlar ve kotalar
UçSınır
REST API (/api/v1)İstemci başına dakikada 120 istek; ürün aramasında 30. Sayfa boyutu en çok 100.
Herkese açık MCP (/api/mcp)IP başına dakikada 120 istek. İstek gövdesi en çok 64 KB.
Kişisel MCP (/api/mcp/me)Kimlik bilgisi başına dakikada 60 istek; yazma çağrılarında ayrıca kullanıcı başına dakika ve gün sınırı. İstek gövdesi en çok 64 KB.
Webhook teslimiYanıtı 10 saniye içinde verin; başarısız teslim 5 dk, 30 dk, 2 sa, 6 sa ve 15 sa sonra yeniden denenir.
Gömme sayfalarıSunucuda 5 dakika önbelleğe alınır; yeni kayıt birkaç dakika içinde listeye yansır.
Teknik destek formuIP başına dakikada 3 gönderim.
HTTP/1.1 429 Too Many Requests · Retry-After: <seconds>

Veri kuralları

Yalnız sayfalarda zaten herkese açık olan bilgiler verilir. E-posta, telefon, açık adres, koordinat ve toplantı bağlantısı verilmez.

Ayrıntılar: Veri kuralları
  • Yalnız onaylı ve herkese açık gönüllülük ilanları listelenir. Başvurusu kapanan ilan listede yer almaz.
  • Bağış oranı STK’ya ulaşan net orandır. Markanın ödediği brüt komisyon verilmez.
  • Metin, kurumun yazdığı dilde gelir. Çevirisi olmayan metin çevrilmiş gibi sunulmaz; translation.status alanına bakın.
  • Kan ihtiyacı kayıtları ve resmî kurum duyuruları akışlarda yer almaz.

Hata kodları

Hata yanıtındaki type adresi bu listedeki ilgili maddeye açılır.

Ayrıntılar: Hata kodları
invalid-parameter
Sorgu parametresi geçersiz. Hangi parametrenin neden reddedildiği invalid-params listesinde yazar.
invalid-cursor
İmleç okunamadı ya da başka bir sorguya ait. Aynı süzgeç ve sıralamayla yeniden isteyin.
not-found
Kayıt yok, herkese açık değil ya da süresi doldu.
method-not-allowed
API salt okurdur; yalnız GET kullanın.
rate-limited
Oran sınırı aşıldı. Retry-After başlığındaki süre kadar bekleyin.
internal-error
Beklenmeyen bir hata oluştu. Biraz sonra yeniden deneyin.
upstream-unavailable
Veri kaynağına şu an ulaşılamıyor. Biraz sonra yeniden deneyin.

Kullanım koşulları

Teknik destek

Soru, hata bildirimi ve veri istekleri için info@hangel.org adresine yazın.

Güvenlik iletişimi

Güvenlik açığı bulduysanız bu forma değil, açık bildirim sayfasına yazın. İletişim ve politika adresi security.txt dosyasında da yer alır (RFC 9116).

Entegrasyon sorunu bildirin ya da geliştirici desteğine yazın. Talep destek kuyruğuna kaydedilir; ekip inceleyip yazdığınız e-posta adresine döner.

İsteğe bağlı olarak işaretlenmeyen alanlar zorunludur.

Ör. https://siteniz.org/sayfa ya da çağırdığınız uç noktası.

Ne yaptınız, ne bekliyordunuz, ne oldu? İstek, yanıt kodu ve zamanı yazın.

Yanıt gövdesi, konsol hatası ya da hata kimliği. Parola, erişim anahtarı ve belirteç yapıştırmayın.

Bu site reCAPTCHA ile korunur; Google Gizlilik Politikası ve Hizmet Şartları geçerlidir.

hangel’ın konuştuğu yazılımlar

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.

Pano yükleniyor…

Tümünü gör: Entegrasyon dizini