Genel Formlar
İletişim, danışmanlık talebi, erişim talebi, hesap etkinleştirme.
“Genel Formlar — API Referansı” sayfası bu URL ile belirtilen işlev alanını açıklar. Mevcut özet gerçek iş akışı, ön koşullar ve bilinen sınırlarla genişletilir. Form oluşturucu tetikleyici anahtar kelimeler, alan türleri ve zorunlu alan işaretleriyle serbestçe yapılandırılabilen formları destekler. İşlev uçtan uca test edilmiştir.
`POST /api/public/contact` bu sayfada açıklanan belirli işlemdir. İstemci HTTP yöntemi, yol, kimlik doğrulama modeli, zorunlu alanlar ve başarısızlık yanıtlarını aynen uygulamalıdır. Zentor genel bir geliştirici API anahtarı sunmaz; rota ya herkese açıktır ya da belgelenen Widget gömme tokenı ve kaynak doğrulamasıyla korunur.
`/api/public/contact` çağrısında HTTP durumu ile JSON gövdesi birlikte değerlendirilmelidir. Doğrulama sorunu, bulunamayan kaynak, reddedilen kaynak, süresi dolmuş tek kullanımlık değer ve sunucu sorunu farklı işlenir. Başarılı çağrı yalnızca bu adımın işlendiğini gösterir; e-posta teslimi, ödeme veya SSO tamamlandığı anlamına gelmez.
`POST /api/public/contact` için anonim test değerleri kullanılmalıdır. Genel örneklerde gerçek müşteri verisi, üretime benzeyen UUID, oturum JWT’si, Widget tokenı veya gerçek zaman damgası bulunmamalıdır. Bilinen platform sınırı 15 dakikada 2.000 istektir; bu endpoint için ayrı bir sınır kanıtlanmamıştır.
İdempotent olmayan POST çağrıları belirsiz ağ kesintisinden sonra otomatik tekrarlanmamalıdır. İlk çağrı yan etki oluşturmuş olabilir. Loglarda durum ve güvenli başarısızlık kodu tutulabilir; parola, doğrulama kodu, sıfırlama tokenı ve diğer gizli bilgiler yazılmamalıdır. Bu nokta “POST /api/public/contact” için doğrudan geçerlidir.
“Genel Formlar — API Referansı” için gerçek kaynak API registry’si, ilgili backend rotası ve testlerdir. Negatif test veya benzer kod yoluna dayanan çıkarım tam canlı doğrulama değildir. Sayfa, bilginin şemadan mı, otomatik testten mi yoksa güvenli canlı gözlemden mi geldiğini açıkça ayırmalıdır.
Sayfa 44 kontrol notu 1: Bu metin yalnızca bu URL için doğrulanmış işlevleri, değerleri ve sorumlulukları içerir. Tenant arayüzünü Master Admin ile, genel API rotalarını dahili endpointlerle karıştırmaz. Ürün değiştiğinde bilgiler kod, veritabanı ve canlı davranışla yeniden kontrol edilmelidir.
`POST /api/public/contact` uygulanırken istemci HTTP durumunu, yapılandırılmış hata kodunu ve güvenli bir iç istek referansını birlikte değerlendirmelidir. Böylece giriş doğrulaması, kimlik doğrulama, kaynak denetimi ve sunucu tarafı işleme hataları birbirinden ayrılabilir. Açık örnekler anonim kalmalı; gerçek parolalar, tokenlar, müşteri kimlikleri veya üretim zaman damgaları dokümana ve destek mesajlarına eklenmemelidir.