Nudge
Nudge destekli · açık bildirim merkezi
← Gelen kutusuna dön

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

1

Kimlik bilgilerini alın

Siteniz için bir "project" oluşturun ve size özel bir token edinin.

2

Event gönderin

Bir olay olduğunda /api/ingest.php adresine bir JSON POST edin.

3

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.

Şu anda erişim davete bağlı: site adınızı, slug'ınızı (örn. your-app) ve kısa bir açıklamayı Nudge yöneticisine göndererek token alın. Nudge'u kendiniz barındırıyorsanız, project ile gelen CLI ile doğrudan oluşturabilirsiniz:
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.

Gönderim endpoint'ihttps://nudgealert.com/api/ingest.php
Metot / Content-TypePOST  ·  Content-Type: application/json

Asgari 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

AlanZorunluAçıklama
tokenEvetproject kimlik bilgisi, sunucu tarafında saklayın
titleHayırUyarı başlığı; varsayılan değer (no title)
bodyHayırGövde metni, satır sonu destekler
topicHayırTopic gruplaması (örn. quota-change); varsayılan değer default, kullanıcılar topic başına abone olabilir
levelHayırinfo / warning / high / critical, varsayılan info
dedup_keyHayırTekilleş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ı

400invalid_jsonİstek gövdesi geçerli bir JSON değil
401missing_tokentoken sağlanmadı
403invalid_tokentoken geçersiz
429rate_limitedproject başına dakikada 60 event sınırı aşıldı
500db_errorSunucu tarafında yazma hatası

Kod örnekleri

YOUR_TOKEN yerine kendi project token'ınızı yazın. Tüm örnekler yalnızca sunucu tarafında çalıştırılmalıdır.

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.

Deep link biçimihttps://nudgealert.com/?sub=<slug>&from=<source>
ParametreAçıklama
subproject slug'ınız (zorunlu), hangi project'e otomatik abone olunacağını belirler
fromKaynak 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>
your-app yerine kendi slug'ınızı, your-site yerine kendi kaynak etiketinizi yazın.

En iyi uygulamalar

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ç →