Herhangi bir site veya uygulamanın değişiklik uyarılarını tek bir ortak gelen kutusuna gönderin
Nudge Entegrasyonu ile Bildirim Alma
Nudge açık bir "bildirim kutusu + abonelik merkezi"dir. Sitenizde bir olay gerçekleştiğinde tek bir JSON verisini bir HTTP endpoint'ine POST etmeniz yeterlidir; kullanıcılar böylece kendi Nudge gelen kutularında uyarıları alır ve diğer sitelerden gelen uyarılarla bir arada görür. Mesaj kuyruğu, e-posta servisi veya push altyapısı kurmanıza gerek yok.
Entegrasyon üç adım ve yaklaşık 10 dakika sürer; SDK gerekmez ve herhangi bir backend diliyle kullanılabilir.
Üç adım
Kimlik bilgilerini alın
Siteniz için bir "project" oluşturun ve size özel bir token edinin.
Event gönderin
Bir olay olduğunda /api/ingest.php adresine bir JSON POST edin.
Kullanıcı aboneliği
Bir deep link düğmesi ekleyin; kullanıcı giriş yaptığında otomatik abone olur ve bir karşılama kartı görür.
Adım 1 · project ve token alın
Her yayıncı tek bir "project" ile eşlenir; slug, display_name ve token değerleri benzersizdir. Event göndermek için tek kimlik bilgisi token olduğundan, mutlaka yalnızca sunucu tarafında tutun ve ön yüz koduna ya da herkese açık bir depoya yazmayın.
php bin/create_project.php your-app "Your App Name"
# çıktı: slug / name / token / ingest endpoint
Adım 2 · Event'ler ingest'e gönderilir
Sitenizde "kullanıcının bilmeye değer" bir değişiklik olduğunda, ingest endpoint'ine bir JSON isteği gönderin. Bu endpoint durumsuzdur: Nudge saklamayı, tekilleştirmeyi, hız sınırlama ve aboneliklere göre teslimatı kendisi yapar.
https://nudgealert.com/api/ingest.phpPOST · Content-Type: application/jsonAsgari istek
curl -X POST https://nudgealert.com/api/ingest.php \
-H "Content-Type: application/json" \
-d '{"token":"YOUR_TOKEN","title":"New free tier available","body":"Groq raised its free RPM to 30."}'
Tüm alanları içeren istek
curl -X POST https://nudgealert.com/api/ingest.php \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_TOKEN",
"topic": "quota-change",
"title": "Groq free quota changed",
"body": "RPM 20 -> 10, effective today.",
"level": "high",
"dedup_key": "groq:rpm:20to10:2026-11-14"
}'
İstek alanları ve yanıtlar
| Alan | Zorunlu | Açıklama |
|---|---|---|
token | Evet | project kimlik bilgisi, sunucu tarafında saklayın |
title | Hayır | Uyarı başlığı; varsayılan değer (no title) |
body | Hayır | Gövde metni, satır sonu destekler |
topic | Hayır | Topic gruplaması (örn. quota-change); varsayılan değer default, kullanıcılar topic başına abone olabilir |
level | Hayır | info / warning / high / critical, varsayılan info |
dedup_key | Hayır | Tekilleştirme anahtarı: aynı project içinde tekrarlanan değer yalnızca bir kez saklanır ve duplicated döner |
Yanıtlar
| Yeni event kaydedildi | { "ok": true, "id": 12 } |
| Tekilleştirme yakalandı | { "ok": true, "duplicated": true } |
Hata kodları
400 | invalid_json | İstek gövdesi geçerli bir JSON değil |
401 | missing_token | token sağlanmadı |
403 | invalid_token | token geçersiz |
429 | rate_limited | project başına dakikada 60 event sınırı aşıldı |
500 | db_error | Sunucu tarafında yazma hatası |
Kod örnekleri
PHP
<?php
$payload = [
"token" => getenv("NUDGE_TOKEN"),
"topic" => "quota-change",
"title" => "Groq free quota changed",
"body" => "RPM 20 -> 10",
"level" => "high",
"dedup_key" => "groq:rpm:20to10:2026-11-14",
];
$ch = curl_init("https://nudgealert.com/api/ingest.php");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
// $res => ["ok" => true, "id" => 12] or ["ok" => true, "duplicated" => true]
Node.js / fetch
const res = await fetch("https://nudgealert.com/api/ingest.php", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: process.env.NUDGE_TOKEN,
topic: "quota-change",
title: "Groq free quota changed",
body: "RPM 20 -> 10",
level: "high",
dedup_key: "groq:rpm:20to10:2026-11-14",
}),
});
const data = await res.json();
// data => { ok: true, id: 12 } or { ok: true, duplicated: true }
Python
import os, json, urllib.request
payload = {
"token": os.environ["NUDGE_TOKEN"],
"topic": "quota-change",
"title": "Groq free quota changed",
"body": "RPM 20 -> 10",
"level": "high",
"dedup_key": "groq:rpm:20to10:2026-11-14",
}
req = urllib.request.Request(
"https://nudgealert.com/api/ingest.php",
data=json.dumps(payload).encode(),
headers={"Content-Type": "application/json"},
method="POST",
)
with urllib.request.urlopen(req) as r:
data = json.load(r) # {"ok": true, "id": 12}
Adım 3 · Tek tıkla abone ol
"Bildirimlere abone ol" düğmesinin arkasına bir deep link koyun. Kullanıcı Nudge'u açıp e-posta ile giriş yaptığında ilgili project'e otomatik abone olur ve gelecekteki bildirimlerin bu gelen kutusuna geleceğini anlatan bir karşılama kartı görür.
https://nudgealert.com/?sub=<slug>&from=<source>| Parametre | Açıklama |
|---|---|
sub | project slug'ınız (zorunlu), hangi project'e otomatik abone olunacağını belirler |
from | Kaynak etiketi (isteğe bağlı), karşılama kartındaki kaynak metni için kullanılır; bilinen kaynaklarda anlaşılır bir ad ve geri bağlantı gösterilir |
Doğrudan düğmeye / e-postaya eklenebilir
<a class="btn" href="https://nudgealert.com/?sub=your-app&from=your-site"
target="_blank" rel="noopener">
Subscribe to quota alerts
</a>
En iyi uygulamalar
- Yalnızca değişiklikte gönderin — Nudge bir durum yoklama aracı değil, "değişiklik bildirimi" aracıdır. Yalnızca kota, fiyat veya durum gerçekten değiştiğinde POST edin, gereksiz rahatsızlık oluşmasın.
- dedup_key'den yararlanın — "nesne + değişiklik" üzerinden kararlı bir anahtar üretin (örn. groq:rpm:20to10); böylece tekrarlanan cron çalışmaları bildirim ekranını doldurmaz.
- Doğru level'ı seçin — info normal gelişmeler, warning dikkat gerektirenler, high önemli, critical acil; kullanıcı önceliği bir bakışta görür.
- topic'e göre gruplayın — Farklı event türlerini farklı topic'lere ayırın; kullanıcılar yalnızca ilgilendikleri konulara abone olabilir.
- token'ı koruyun — token'ı yalnızca sunucu ortam değişkeni / yapılandırmasında saklayın; sızarsa hemen yöneticiden sıfırlamasını isteyin.
- Sunucu tarafından çağırın — Her zaman backend üzerinden gönderin, token'ı tarayıcıya veya istemciye açmayın.
Sıkça sorulan sorular
SDK veya hesap gerekli mi?
Hayır. Yayıncı için yalnızca bir token ve tek bir HTTP POST yeterlidir; abone kullanıcılar parola olmadan e-posta ile Nudge'a giriş yapar.
Event'ler tüm kullanıcılara mı gider?
Yalnızca project'inize (ve ilgili topic'e) abone olan kullanıcılara gider. Başkaları göremez.
Gönderimde bir hız sınırı var mı?
Evet, project başına dakikada en fazla 60 event (429 rate_limited). Toplu event'leri birleştirin veya farklı zamanlara dağıtın.
Kendi Webhook'uma iletilebilir mi?
Evet. Kullanıcı abone olurken bir ileri webhook girebilir; Nudge event'leri WeCom / Slack / Telegram / özel endpoint'lere yeniden dağıtır.
Gerçek zamanlı mı?
Event kaydedildiği anda kullanıcı tarafından görülebilir (gelen kutusu). Tarayıcı bildirimi / e-posta gibi kanallar kullanıcı tarafı yapılandırmasına ve ileride açılacak özelliklere bağlıdır.
Entegrasyona hazır mısınız?
Site bilgilerinizi yöneticiye göndererek token alın, yukarıdaki örneklerden birini kopyalayın ve iki satırı değiştirin; ilk uyarınız Nudge'a düşer.
Nudge gelen kutusunu aç →