confirm_card

Çizilmiş güvenlik mekanizması. Bir yazma veya yıkıcı aksiyon çalıştırılmadan önce sunucu, aksiyon manifestinizden bir confirm_card sentezler: özet confirmTemplate bilginizden gelir, parametreler sunucunun zaten doğrulamış olduğu çağrıdan gelir ve model bunların hiçbirine dokunmaz.

Tüm mesele de budur. Model kartı yazmadığı için bir halüsinasyon, son kullanıcının neyi onayladığını yanlış aktaramaz.

Karttaki her tutar, aksiyonlarınızın döndürdüğü veriye göre kontrol edilir; önündeki simge de öyle. Verinin para birimi, sonuçlarınızın taşıdığı ISO kodudur ("currency": "AUD"); kartta bu anlama gelemeyecek bir simge veya kod doğru olanla değiştirilir; böylece bir AUD siparişi için EUR 8.41, hiçbir zaman atlanmadan A$8.41 haline gelir. Yalın bir $, herhangi bir dolar anlamına gelir.

Aksiyonun editable olarak işaretlediği parametreler, son kullanıcının onaylamadan önce değiştirebileceği kontroller olarak çizilir ve her değişiklik sunucuda tekrar kontrol edilir. Bkz. Kart üzerinde son kullanıcının değiştirebileceği değerler.

Flutter SDK ve Web SDK ile, her ikisi de 0.1.0 sürümünden itibaren yerel olarak render edilir.

Ne zaman kullanılmamalı

Bunu siz kullanamazsınız. confirm_card, modelin üretemeyeceği tek blok türüdür. Yapısı gereği render_ui aracında yer almaz ve hiçbir ana uygulama kodu da bunu oluşturmaz.

Son kullanıcının seçenekler arasından seçim yapmasını istiyorsanız bunun için choice veya product_cards kullanılır. Değer girmesini istiyorsanız bu form bileşenidir. Onay bir seçim değildir; zaten tamamen belirlenmiş bir şeyin onaylanmasıdır.

Props

Her blok ayrıca type ve 1 ila 300 karakterlik zorunlu bir fallback_text taşır.

Ağ üzerinde

{
  "id": "blk_09",
  "type": "confirm_card",
  "fallback_text": "Confirm cancelling order 1042.",
  "props": {
    "invocation_id": "inv_8f21",
    "action_name": "cancel_order",
    "summary": "Cancel order 1042 and refund $129 to the original card?",
    "params": {
      "order_id": "1042"
    },
    "params_display": [
      {
        "label": "order_id",
        "value": "1042"
      }
    ],
    "risk": "destructive",
    "confirm": {
      "kind": "confirm",
      "invocation_id": "inv_8f21"
    },
    "cancel": {
      "kind": "cancel",
      "invocation_id": "inv_8f21"
    },
    "expires_at": "2026-08-27T10:10:00Z"
  }
}

Etkileşim

Onaylama işlemi, kayıtlı işleyicinizi params ile çalıştırır ve sonucu yeni bir istek olarak iletir. Kart executes: "server" (bir yönetim paneli aksiyonu) taşıdığında cihaz hiçbir şey çalıştırmaz: onayı kaydeder, API çağrıyı oturum açmış kullanıcı olarak yapar ve yanıt ne olduğunu belirtir. Geri dönme işlemi declined araç sonucunu iletir, böylece sıra her iki durumda da çözümlenir ve yanıt asla kimsenin yanıtlamadığı bir kartta takılıp kalmaz.

params_display bir render gösterimidir. İçindeki her değer String() işleminden geçirilmiş ve 200 karakterde kesilmiştir, bu nedenle bundan hiçbir şey yeniden oluşturulamaz. SDK ya params çalıştırır ya da hiçbir şey çalıştırmaz. Bir şekilde makinece okunabilir parametreler olmadan gelen bir kart, tahmin yürütülerek çalıştırılmak yerine hata olarak bildirilir.

Burada yalnızca confirm ve cancel geçerlidir. Genel UIAction birleşimi geçerli değildir.

Durumlar

Erişilebilirlik

Kart, ekran okuyucu kullanan birinin yanıtta duyacağı en önemli öğedir. fallback_text sunucuda yazılır ve aksiyon ile nesnesini belirtir. Her iki buton da 44pt boyutundadır ve sonuç canlı bölge (live region) olarak duyurulur, böylece son kullanıcı aramak zorunda kalmadan sonuç seslendirilir.