pass
Son kullanıcının gösterdiği bir şey: bilet, biniş kartı, teslim alma kodu, kupon.
Gösterilecek bir şey. pass, son kullanıcının bir bankoda veya kapıda gösterdiği şeydir: bilet, biniş kartı, teslim alma kodu, kupon, üyelik kartı — bir başlık, birkaç alan (kapı, koltuk, saat) ve bir kod.
Sunucu, kodu value değerinden bir QR, Code 128, PDF417 veya Aztec kodu olarak çizer ve kod, sessiz bir alanla birlikte tam boyutta çizilmek üzere modüller hâlinde SDK'ya ulaşır; modelin kendi bloğu bunu asla taşımaz. wallet bağlantılarıyla pass, Apple Wallet'a Ekle veya Google Wallet'a Kaydet seçeneklerini sunar.
Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.
Flutter SDK ile 0.43.0 ve Web SDK ile 0.20.0 sürümünden itibaren yerel olarak render edilir. Bunu bildirmeyen bir derlemeye asla sunulmaz.
Sunucunun kontrol ettikleri
Kodun değeri ve cüzdan bağlantıları, aksiyonlarınızdan birinin döndürdüğü değerle birebir aynı olmak zorundadır: uydurma bir barkod, sahte bir bilettir.
Props
Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
kind | boarding | ticket | pickup | coupon | membership | Evet | Yok |
title | string | Evet | 1 ila 80 karakter. |
subtitle | string | Hayır | En fazla 120 karakter. |
fields | array | Hayır | En fazla 8 girdi. |
fields[].label | string | Evet | 1 ila 30 karakter. |
fields[].value | string | Evet | 1 ila 60 karakter. |
code | object | Hayır | Yok |
code.format | qr | code128 | pdf417 | aztec | Evet | Yok |
code.value | string | Evet | 1 ila 500 karakter. |
code.display_text | string | Hayır | En fazla 60 karakter. |
code.matrix | object | Hayır | Kodu çizen sunucu doldurur; model çıktısında asla yer almaz. Yalnızca kendi renderer'ınız içinde okuyun. |
code.matrix.rows | integer | Evet | 1 ila 200. |
code.matrix.cols | integer | Evet | 1 ila 200. |
code.matrix.bits | string | Evet | En fazla 8000 karakter. |
code.matrix.module_aspect | number | Evet | 1 ila 4. |
code.bars | integer[] | Hayır | Her biri 1 ila 4 arasında en fazla 600 tam sayı. Kodu çizen sunucu doldurur; model çıktısında hiçbir zaman yer almaz. Yalnızca kendinize ait bir renderer içinde okuyun. |
wallet | object | Hayır | Yok |
wallet.apple_pkpass_url | string | Hayır | Yalnızca https. |
wallet.google_save_url | string | Hayır | Yalnızca https. |
valid_until | string | Hayır | Farkıyla birlikte ISO 8601 (2026-10-10T09:30:00+03:00) veya Z. |
Ağ üzerinde
Model code.value değerini gönderir; blok cihaza ulaşmadan önce sunucu çizilen modülleri ekler.
{
"id": "blk_88",
"type": "pass",
"fallback_text": "Pickup code 4821 for order 1042 at Kalverstraat, valid until 12 October.",
"props": {
"kind": "pickup",
"title": "Order 1042",
"subtitle": "Neon Kicks Kalverstraat",
"fields": [
{ "label": "Pickup code", "value": "4821" },
{ "label": "Items", "value": "2" }
],
"code": { "format": "qr", "value": "NK-1042-4821", "display_text": "4821" },
"valid_until": "2026-10-12T20:00:00+02:00"
}
}