Ana içeriğe atla

Herkese açık API ve akışlar

hangel’daki herkese açık bilgiyi başka sitelere ve uygulamalara taşımanın iki yolu var. İkisi de ücretsiz, anahtar istemez ve kişisel veri vermez.

Fark tek cümlede

API, yazılımcının kendi uygulamasına hangel verisini çekmesi içindir; gömme kodu ve akışlar ise kod bilmeyen bir kurumun ilanlarını kendi sitesinde kopyala-yapıştır ile göstermesi içindir.

Geliştiriciler için API

İki yazılımın konuştuğu kapı. Sayfalarımızda zaten herkese açık olan bilgiyi düzenli ve makinenin okuyabileceği biçimde verir.

  1. hangel

  2. API v1 · OpenAPI 3.1

    • /api/v1/ngos
    • /api/v1/events
    • /api/v1/volunteering
    • /api/v1/funds
    • /api/v1/stores
    • /api/v1/products
    • /api/v1/library
    • /api/v1/platform
  3. Senin uygulaman

  • Belgeli: bütün uçlar, parametreler ve yanıtlar OpenAPI 3.1 belgesinde.
  • Salt okunur: yalnız okur, hiçbir şey yazmaz ya da silmez.
  • Anahtarsız ve ücretsiz; adil kullanım için dakikada istek sınırı var.
  • Kişisel veri yok: e-posta, telefon, açık adres verilmez.

Örnek istek

curl "https://hangel.org/api/v1/volunteering?city=izmir&limit=5"
200 OK · application/json

API’yi üç adımda kullan

  1. OpenAPI belgesini aç ya da Postman gibi bir araca yükle.

  2. Örnek isteği dene: şehrindeki gönüllülük ilanlarını çek.

  3. Sayfalama ve süzgeçlerle kendi uygulamana bağla.

Kurumlar için gömme kodu ve akışlar

Kod yazmadan: STK’nın, kulübün ya da şirketin kendi sitesinde hangel ilanları görünür ve kendiliğinden güncellenir.

  1. hangel

  2. Gömme kodu · RSS · JSON

  3. Kurumun sitesi

    • Akış okuyucu

Sitene üç adımda ekle

  1. Kurum panelinde “Sitene ekle” bölümünü aç.

  2. Görünümü seç ve kodu kopyala.

  3. Kodu sitende istediğin yere yapıştır; yeni ilanlar kendiliğinden görünür.

Gömme kodu

Etkinlik ve gönüllülük ilanlarını, üye rozetini ya da tek bir etkinliği sitende gösteren hazır parçalar.

Gömme kodlarını gör

RSS ve JSON akışları

Akış okuyucular, haber toplayıcılar ve başka siteler yeni kayıtları buradan kendiliğinden alır. Her kurumun kendi ilan akışı ve takvimi de var.

Kurum takvimi (ICS): https://hangel.org/takvim/kurum/{id}.ics

Tüm teknik ayrıntılar

Hangisi sana uygun?

Yazılımcıysan API’den, kurumun sitesine ilan koymak istiyorsan gömme kodundan başla. Takıldığında geliştirici merkezindeki destek formu sana yardımcı olur.

Bir kavrama mı takıldın? hangel Sözlüğü