Endpoint bağlama

Rendel'in oturum açmış son kullanıcı olarak, tek bir senkronizasyonla veya hiçbir yapay zekâ kodlama aracı olmadan API'nizin endpoint'lerinden birini çağırmasını sağlayın.

Uygulamanız Rendel'in kullanması gereken bir API'yi çağırdığında: sipariş arama, rezervasyonları listeleme, adres değiştirme.

Ne değişti?

The app now calls {METHOD /path} to {what it does}. Let Rendel use it as the signed-in user.

Sync with code altındaki Ne değişti? alanına yazın, ardından size verilen adımları izleyin. Claude Code, Cursor, Codex, Windsurf, GitHub Copilot ve Gemini CLI üzerinde çalışır.

Asistanın yapacağı

Endpoint düz HTTPS olduğunda, bunu Rendel sunucusunun çağırdığı bir aksiyon hâline getirir. Bu, daha sonra yeni bir sürüm çıkarmadan yönetim panelinde düzenlenir.
Bunun yerine, yalnızca bir sunucu çağrıyı yapamadığı durumlarda uygulamanızın koduna registerAction ile kaydeder: bir Firebase veya GraphQL istemcisi, imzalı istekler, dahili bir ağ, cihaz içi durum.
Her parametreyi tanımlar ve son kullanıcının önce onaylaması için veriyi değiştiren her şeyi write veya destructive olarak işaretler.
Asla bir anahtar göndermez. Paylaşılan bir API anahtarı gerektiren bir endpoint, anahtarı eklemeniz için kapalı olarak kaydedilir.

Çalıştığını kontrol etme

Actions sayfası bunu On server altında (veya bir derlemeden sonra In app code altında) listeler. Add key yazıyorsa anahtarı oraya girin. Test sayfasında, Talk as altından bir kullanıcı seçin ve endpoint'in yaptığı şeyi isteyin.

Referans: ne yazdığı

Yalnızca uygulamanızda çalışması gereken bir aksiyon için:

Flutter

Rendel.registerAction(RendelAction(
  name: 'cancel_order',
  description: 'Cancel an order that has not shipped yet',
  params: RendelSchema.object({'order_id': RendelSchema.string()}),
  risk: RendelRisk.destructive,
  confirmTemplate: 'Cancel order {order_id}? This cannot be undone.',
  handler: (params) async => RendelResult.ok({'refund_eta_days': 5}),
));

Cümlenin tek bir yapıştırma işlemine nasıl dönüştüğü: Değişiklik sonrasında senkronizasyon.

Bir yapay zekâ kodlama aracı olmadan

Actions → On server sekmesinde, Connect an API bir tarayıcıda çalışan bir adresi veya API'nizin dokümantasyonunu (OpenAPI veya Swagger, bir YAML belirtimi, bir PDF referansı, bir Postman koleksiyonu) alır, endpoint'leri listeler ve siz de Rendel'in kullanabileceği olanları işaretlersiniz.

Bir şeyi değiştiren bir aksiyonda, What each value can be bölümünde her değerin yanında Changeable on the card yer alır. Bunu, son kullanıcının onaylamadan önce onay kartında değiştirmek isteyebileceği bir değer için işaretleyin: bir miktar, bir not veya gerekçe, birkaç seçenekten biri. Sunucu, değiştirilen değeri modelin kurallarıyla aynı kurallarla denetler. Bir id ve uygulamanızın hesapladığı herhangi bir tutar için bunu kapalı bırakın. Bkz. son kullanıcının kartta değiştirebileceği değerler.

Çağrının kimin adına yapıldığı

Oturum açma şekli	İzin verilen
Paylaşılan bir anahtar veya Rendel için oluşturulmuş bir hesap	Yalnızca okuma
Oturum açmış son kullanıcı (uygulamanız token'ını Rendel'e iletir)	Okuma ve son kullanıcı onayladıktan sonra bir şeyi değiştirme

Bir değişiklik her zaman bir onay kartı gerektirir; bu, sunucu endpoint'inizi çağırmadan önce bir kez kaydedilir. Token'ın Rendel'e ulaşması için uygulamanızın bunu iletmesi gerekir: bkz. Giriş yapma ve kimlik. Kuralların tamamı için: aksiyonlar ve risk seviyeleri.

Bir yapay zekâ kodlama aracı olmadan

Çağrının kimin adına yapıldığı

Bu sayfada