Do the endpoints return 2xx, does the badge open the profile, does the list load? If you are stuck, fill in the developer support form.
Progress is stored locally in this browser and is never sent to a server.
Public API (v1)
Bring NGOs, events, volunteering opportunities, open funding calls, hangel Market and the library to your website, app or AI assistant. Only information that is already public on our pages is returned.
Example request
$ curl "https://hangel.org/api/v1/volunteering?city=izmir&limit=5"
200 OK · application/json
Details: Public API (v1)
Responses are JSON. Every record carries its permanent page URL, last update time, content language and translation status.
Acts on behalf of a signed-in user or organisation admin (Streamable HTTP, stateless). It requires an OAuth 2.1 access token or a personal access key; an unauthenticated request gets 401 with the OAuth discovery header.
The public API and the public MCP server need no key. The endpoint that acts for a user or organisation (/api/mcp/me) accepts one of two credential types.
No key
/api/v1 and /api/mcp: read-only, public data only, no personal data.
Personal access key
Authorization: Bearer hgl_pat_…. Keys are created and revoked on the Projeni Yaz › Connection page; the server stores only a digest.
OAuth 2.1 access token
Authorization: Bearer hgl_oat_…. The ChatGPT app and the Claude connector connect this way.
Authorization code flow; PKCE S256 is required. No client authentication (public client, token_endpoint_auth_method: none).
Client registration: a client ID metadata document (CIMD) for chatgpt.com, claude.ai and claude.com; every other client registers through dynamic client registration (DCR).
The redirect URI must be https; http is accepted for loopback (127.0.0.1, localhost, [::1]). It may not contain a fragment (#) or user info.
The resource parameter (RFC 8707) sets the token audience: hangel.org, /api/mcp, /api/mcp/chatgpt or /api/mcp/me. Responses carry the RFC 9207 iss parameter.
Tokens are opaque (not JWT). Access tokens last 1 hour; refresh tokens last 30 days and rotate on every use; the authorization code lasts 5 minutes and is single-use.
Scopes
Each tool needs one scope; without it the tool returns insufficient_scope. Write scopes change things on the user’s behalf and every action goes through a two-step confirmation. Payment is never made by an AI.
drafts:readType: Read
Projeni Yaz taslaklarımı okuma
account:readType: Read
Başvurularımı, etkinlik kayıtlarımı, sertifikalarımı ve tercihlerimi okuma
volunteer:applyType: Write
Gönüllülük ilanlarına benim adıma başvurma
events:rsvpType: Write
Etkinliklere benim adıma katılma ve katılımımı iptal etme
follows:writeType: Write
STK takip etme, takibi bırakma ve ilan kaydetme
profile:writeType: Write
Profil tercihlerimi, desteklediğim STK seçimimi ve kan bağışı ayarlarımı güncelleme
emergency:respondType: Write
Açık kan ihtiyacına benim adıma "Gelebilirim" yanıtı verme
drafts:writeType: Write
Projeni Yaz taslağı oluşturma ve güncelleme (silme yok)
feedback:writeType: Write
Katıldığım etkinliği benim adıma değerlendirme
org:readType: Read
Yönettiğim kurumların etkinlik, ilan, başvuru, katılımcı ve rapor bilgilerini okuma
org:draftType: Write
Yönettiğim kurumlar için taslak hazırlama (yayın ve gönderim panelde benim onayımla)
market:readType: Read
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:writeType: Write
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)
Embeds and widgets
Organisations paste these pieces into their own websites. All of them run from public URLs and need no key. The snippets here come from the same code as the generators in the organisation panel.
Organisation ID
If you leave it empty, the snippets show the YOUR_ORG_ID placeholder.
Details: Organisation ID
The ID is the last segment of your public profile URL: hangel.org/ngos/{orgId}, /market/{orgId} or /clubs/profile/{orgId}. In the panel, the “Add to your website” section of the “Share links” page pre-fills it.
Replace the YOUR_ORG_ID, YOUR_EVENT_ID, YOUR_LISTING_ID and YOUR_REF_CODE placeholders in the code with your own values.
Member badge (“hangel member”)
One line of HTML for your site; the badge links to the organisation’s hangel profile. SVG for the web, PNG for email signatures. No JavaScript, no cookies.
An iframe plus a short script that sizes it to its content. Only public events and opportunities appear; the page is cached for 5 minutes. Without the script, the iframe line works on its own.
Gajeren rubutun da ke cikin lambar yana daidaita tsayin firam bisa jerin. Idan shafinka bai yarda da rubutun ba, layin farko (iframe) kaɗai ma yana aiki.
Dubawa
Enter your organisation ID above for a live preview.
Parameters
show: List — all (default), events or volunteering.
lang: List language — the 12 site languages; ar and fa render right-to-left.
compact=1: hides the repeated organisation row on a single organisation’s page.
A single event or opportunity
The same embed narrowed to one record. The record ID is the ID in the event or opportunity page URL; the panel also hands you the finished code.
event: show only this event (on the events embed).
listing: show only this volunteering opportunity (on the volunteering embed).
lang: List language — the 12 site languages; ar and fa render right-to-left.
compact=1: hides the repeated organisation row on a single organisation’s page.
Live stream player (Saye)
If the organiser has opened the live stream to the web on the opportunity, the player can be embedded in your site. No sign-in is needed; viewers only watch and are hidden participants in the room.
yt=1: use the YouTube player when the organiser supplied a YouTube stream.
lang: interface language (default tr).
Tracked share link
Append ?ref=<code> to any hangel event or opportunity URL; clicks, sign-ups and attendance that come through the link are counted in the panel. The code is created in the panel and is specific to the organisation.
Shirye-shirye 42 suna haɗuwa kai tsaye. 59 rabin kai tsaye ne: ta Excel/CSV, biyan kalanda ko kwararar bayanai. 39 ana haɗa su da hannu ko ba su da haɗi kwata-kwata. Daga cikinsu, 7 ba su cancanci a saita su ba.
hangel Disaster Walkie-Talkie is open source (Apache-2.0). Without internet or mobile network, nearby phones share voice messages, short texts and help calls over Bluetooth and peer-to-peer Wi-Fi. It does not replace 112.
140 programs in 16 sectors: HR, NGO, events, e-commerce, accounting, CRM, web and AI. Search by name, filter by sector, and see each program’s connection level and the hangel building block behind it.