TAARIFA ZA JUKWAA · UWEZO & MIPAKA

Vipengele vya mamlaka, wazi mipaka ya uendeshaji.

Lugatu imeundwa kuzunguka mipaka ya kiutendaji ya ukweli: usanidi sifuri wa SMTP inayotoka nje, udumifu wa hifadhidata kabla ya arifa, na uhasibu wa uwazi wa kiasi. Kagua seti zetu za vipengele vilivyothibitishwa, vikomo vya mfumo, na tofauti za usanifu hapa chini.

Anza Bila Malipo katika Beta → Chunguza Nyuma ya Fomu

1. Fomu ya Kumeza & Usanifu wa Uchapishaji

Lugatu inaauni miundo mitatu mahususi ya umezaji iliyoundwa ili kusawazisha utumaji haraka na usalama wa biashara: (1) Fomu za Mwenyeji Isiyo na Kikoa zilizo na viambatisho safi vya umma (https://www.lugatu.com/f/{slug}) zinazohitaji usanidi wa kikoa sifuri; (2) Hati za Mwisho za Fomu ya Upande wa Mteja kwa HTML5, React, Next.js na Astro; na (3) API ya REST ya Kuingiza Seva-kwa-Seva imethibitishwa kupitia vitufe vya API vya faragha (POST /api/v1/forms/{formId}/submissions).

info

Kila fomu inaauni hali ya papo hapo ya kugeuza kati ya Hali ya Kawaida ya Kuuliza na Hali ya Utafiti yenye uwekaji wa hatua nyingi, uelekezaji upya maalum wa kukamilisha, na vidhibiti otomatiki vya uwezo wa orodha ya wanaosubiri.

server-to-server-ingestion.sh bash

curl -X POST https://www.lugatu.com/api/v1/forms/FORM_ID/submissions \
  -H "Authorization: Bearer lug_live_01923456789abcdef0123456789abcde" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lug_idem_01923456789a7b3fb3a1123456789abc" \
  -d '{"fields":{"name":"Alex Morgan","email":"alex@example.com","message":"Technical inquiry"}}'

Simu kutoka kwa seva hadi seva hupita CORS na vizuizi vya asili ya kivinjari, ambazo zimethibitishwa kwa usalama na tokeni za Bearer.

2. Usanifu wa Kiasi & Vikomo vya Arifa za Barua pepe

Uwasilishaji wa arifa ni wa kuchagua kuingia kwa kila fomu (ZIMA, PAPO HAPO, KILA SIKU_MUHTASARI, WIKI_MUHTASARI). Kila kikoa kikuu kilichoidhinishwa kwa kujitegemea (eTLD+1) hupokea barua pepe 500 zinazotumwa kwa kila mwezi wa kalenda ya UTC, zinazoshirikiwa katika vikoa vidogo vyote, na hadi visanduku 2 vya barua pepe lengwa vilivyothibitishwa. Tofauti na huduma za fomu ya urithi ambazo hutupa mwongozo unapofikia kikomo cha barua pepe, Lugatu hutekeleza kiotomati kila jibu halali kwa PostgreSQL: kiwango cha juu cha kumalizika kwa muda huripoti arifa kama SuppressedByQuota huku ikihifadhi kwa usalama swali katika Kikasha cha kati.

warning

Ili kudumisha sifa ya mfumo na kuzuia matumizi mabaya ya barua taka, fomu zisizo na kikoa zinazojitegemea huhifadhi mawasilisho moja kwa moja kwenye kikasha chako cha dashibodi bila kutuma barua pepe zinazotoka nje hadi kikoa kikuu maalum kilichoidhinishwa kiunganishwa.

3. Kudumu kwa Data, Concurrency & Uwezo wa Kusafirisha nje

Hakuna vikomo vya hesabu bandia vya kila mwezi kwenye fomu halali ya kawaida au mawasilisho ya uchunguzi wakati wa beta ya umma. Mawasilisho yanayoingia hupitia uendelevu wa shughuli za atomiki na uzuiaji unaorudiwa kupitia funguo za utambulisho za mteja au seva (lug_idem_...). Wanachama wa Workspace wanaweza kutuma mawasilisho yaliyochujwa kwenye UTF-8 CSV au JSON wakati wowote. Nambari za sehemu zinaweza kufikia KB 64 kwa kila sehemu ya mtu binafsi, na jumla ya miili ya ombi ikiwekewa 1 MB kwenye lango la API.

tip

Vifunguo vya kutokuwa na uwezo huondoa rekodi zilizorudiwa zinazosababishwa na majaribio ya mtandao wa simu: kuwasilisha tena kwa ufunguo unaofanana huleta HTTP 200 Sawa na isDuplicate: kweli na kitambulisho cha uwasilishaji asili bila vihesabio vya kuongeza maradufu.

4. Usanifu wa Usalama, Vyungu vya Asali & Uthibitishaji Asili

Lugatu inatekeleza utetezi wa matumizi mabaya ya tabaka nyingi: (1) Sehemu mahiri za chungu cha asali ambazo hunasa vikwaruo otomatiki vya fomu bila mtumiaji wa CAPTCHA; (2) uthibitishaji wa Cloudflare Turnstile bot kwa fomu za hatari za umma; (3) Hukagua asili ya kivinjari ambacho kinakataa funguo za API za seva hadi seva (lug_live_...) kwa kutumia HTTP 403 FORBIDDEN_BROWSER_ORIGIN; na (4) Kupunguza viwango kwa kila IP ya mteja na sehemu ya mwisho ya uwasilishaji.

5. Uthibitishaji, Nonces & Ahadi za Faragha

Watumiaji huthibitisha kupitia barua pepe na nenosiri lililothibitishwa au Huduma za Utambulisho za Google (GIS). Lugatu huhifadhi tu kitambulisho thabiti cha somo la Google (ndogo), barua pepe iliyothibitishwa na jina la wasifu. Tokeni ghafi za ufikiaji za OAuth na manenosiri ya nje hayaombwi kamwe au kuhifadhiwa. Nonces za hali ya OAuth huisha muda baada ya dakika 5 na ni za matumizi moja tu. Lugatu inafanya kazi chini ya ahadi za faragha zilizothibitishwa za mauzo ya sifuri na sifuri-matangazo: data ya mwasilishaji fomu haionyeshwi wasifu, kuuzwa, au kutumiwa tena.

Tofauti ya Usalama na Uthibitishaji

Tofauti ya Kiufundi: Vifunguo vya API vya Seva-kwa-seva (lug_live_...) hazipaswi kamwe kupachikwa katika HTML ya upande wa mteja, JavaScript, au hazina za umma. Maombi ya kivinjari yaliyo na funguo za moja kwa moja yamezuiwa kiotomatiki.

Utatuzi na Hitilafu za Kawaida za Kumeza

Arifa iliyotiwa alama kama SuppressedByQuota

Kikoa chako cha mizizi kilichothibitishwa kimetuma vitengo vyote 500 vya barua pepe vya kila mwezi. Hoja huhifadhiwa kwa usalama katika dashibodi yako na arifa zitaendelea mwezi ujao wa kalenda ya UTC.

HTTP 403 FORBIDDEN_BROWSER_ORIGIN

Kitufe cha faragha cha API (lug_live_...) kiliwasilishwa kutoka asili ya kivinjari cha umma. Tumia mwisho wa mteja wa umma (/api/v1/public/forms/...) au mawasilisho ya seva mbadala kupitia seva yako ya nyuma.

Arifa za barua pepe hazitumiwi kwa fomu za kujitegemea

Fomu za kujitegemea zisizo na kikoa hunasa mawasilisho moja kwa moja kwenye kikasha chako cha dashibodi bila utumaji barua pepe wa nje. Ongeza na uthibitishe kikoa maalum ili kuwezesha arifa za barua pepe zinazotoka.

Uwasilishaji unaorudiwa unarudisha HTTP 200

Wasilisho lilikuwa na Idempotency-Key inayolingana na rekodi iliyopo. Lugatu alirejesha kwa usalama kitambulisho asili cha uwasilishaji kilicho na isDuplicate: kweli bila kuunda nakala.

Maswali Yanayoulizwa Mara Kwa Mara

Nini kitatokea wakati kikomo changu cha barua pepe 500 kila mwezi kinapofikiwa?

Lugatu haifuti wala kudondosha mawasilisho yako. Kila swali litaendelea kutafutwa na kupatikana katika kikasha chako. Utumaji barua pepe pekee ndizo zimesitishwa kwa muda hadi mwezi ujao wa kalenda.

Je, ninaweza kutumia Lugatu bila kumiliki tovuti au kikoa maalum?

Ndiyo. Fomu zinazopangishwa bila kikoa (https://www.lugatu.com/f/{slug}) hukuwezesha kushiriki fomu za kujibu au tafiti papo hapo kupitia kiungo cha moja kwa moja, wasifu wa kijamii au msimbo wa QR ukiwa na usaidizi kamili wa kikasha pokezi.

Je, kuna vikomo vya kuhesabu majibu ya kila mwezi?

Hakuna vikomo vya kuhesabu majibu ya kila mwezi ya kibiashara vinavyowekwa wakati wa beta ya umma kwa fomu halali ya kawaida na matumizi ya uchunguzi.

Je, kushiriki sehemu ya upendeleo ya kikoa cha mizizi hufanyaje kazi?

Unapothibitisha mfano.com, vikoa vidogo vyote (app.example.com, shop.example.com) na fomu zinazohusiana hushiriki posho moja ya kila mwezi ya barua pepe 500, na hadi anwani mbili za kulengwa zilizothibitishwa.

Je, uko tayari kuunda mwisho wa fomu yako?

Anza bila malipo kwa sekunde chache. Hakuna kadi ya mkopo inahitajika.

Anza Bure →