Ders 5 / 97 dk okuma

Eylemler: sunucu tarafı iş (devany.fn)

Uygulamanın dışarıya çıkması, gizli anahtar kullanması ve dışarıdan bildirim alması — kod yazmadan.

Üretilen uygulama tarayıcıda çalışır ve dışarıya hiç çağrı yapamaz — bu bilinçli bir güvenlik sınırıdır: sayfaya konan bir API anahtarı sızmış anahtardır. Dış dünyaya gereken işleri EYLEMLER yapar: sahip ne istediğini anlatır, platform doğrulanabilir bir tarif kurar, uygulama o tarifi adıyla çağırır.

Bir eylemin yolu

Anlat
"Kargo API'sinden takip no al"
Tarif kurulur
Model adımları yazar
Makine denetler
Sır kaçışı, host, sınır
Sen onaylarsın
Onaysız çalışmaz

Uygulamadan çağrı

js
// Eylem sunucuda koşar; anahtar tarayıcıya hiç gelmez.
try {
  const out = await devany.fn('fetch_tracking', { orderId: order.id });
  show(out.trackingNo);
} catch (e) {
  // 'no_such_action'  → sahip henüz tanımlamadı
  // 'action_disabled' → tanımlı ama kapalı
  // 'rate_limited'    → saatlik tavan doldu
  note('Takip numarası şu an alınamadı.');
}

Eylem yokken ekran ÇALIŞMAYA devam etmeli: yeteneği gizle ya da kibar bir not göster.

Keyfî kod vs doğrulanabilir tarif

Sunucu kodu yazmak
  • Kod yazmayan kitleye kod yazdırır
  • Sandbox kaçışı, sonsuz döngü, sır sızması riski
  • Fonksiyon başına deploy
  • Hata "çalışan ama yanlış kod" olarak prod'a gider
DevAny eylemleri
  • Anlatırsın, tarifi okuyup onaylarsın
  • eval yok; adım sayısı ve süre üstten sınırlı
  • Deploy yok — tek yorumlayıcı, kenarda
  • Hata doğrulamada yakalanır, ekranda uyarı olur

Dışarıdan gelen bildirim (webhook)

  1. 1
    Eylemi "dışarıdan tetiklenebilir" yap

    Panoda kaydederken bu seçeneği aç; eyleme özel gizli bir adres üretilir.

  2. 2
    Adresi karşı tarafa ver

    Ödeme sağlayıcısı, form servisi ya da otomasyon bu adrese POST eder. Adres yalnız bir kez gösterilir.

  3. 3
    Gövde girdi olur

    Gelen JSON tarifin girdisidir; sorgu parametreleri de `query` altında gelir.

  4. 4
    İptal tek dokunuş

    Eylemi kapatmak adresi anında ölü hâle getirir; sızan bir adresin etkisi tek eylemle sınırlıdır.

Kendi başına koşan görevler

  1. 1
    Bir eylem tanımla

    Zamanlanan şey keyfî kod değil, ONAYLADIĞIN bir eylemdir — zamanlayıcı yeni bir risk açmaz.

  2. 2
    Sıklığı ve saati seç

    Her saat, her gün, her hafta ya da her ay. Cron ifadesi yazmazsın; saat dilimin dikkate alınır (yaz saati dahil doğru).

  3. 3
    Sonraki çalıştırmayı gör

    Pano her görevin sonraki çalışma zamanını, kaç kez koştuğunu ve son sonucu gösterir.

  4. 4
    Örnek kullanımlar

    Sabah özeti e-postası, gecelik stok senkronu, haftalık rapor, ayın ilk günü fatura hatırlatması.

Bir tarifte kullanılabilen adımlar

Ne yapar
httpİzin verilen bir adrese istek (sır kullanılabilir)
db.list / db.put / db.removeUygulamanın kendi koleksiyonları
mailİşlemsel e-posta (e-posta açıksa)
set / if / returnDeğer hesapla, koşul, sonuç
döngüYOK — çalışma süresi bilerek üstten sınırlı

Özet

  • Uygulama dışarıya çıkamaz; eylem sunucuda onun adına çıkar.
  • Kod yazmazsın — tarif üretilir, doğrulanır ve senin onayınla açılır.
  • Sırlar yalnız dış isteğe enjekte edilir; tarayıcıya asla dönmez.
  • Bir eylemi zamanlayabilirsin — cron ifadesi yazmadan, saat diliminle.

İlgili konular

Hâlâ takıldın mı? Köşedeki asistana sor ya da SSS'ye göz at.