Qëllimi i aplikacionit KiwiBee

Përditësuar së fundi: 2026-09-25

KiwiBee është një platformë falas me burime për mësuesit. Për t'i mbajtur falas fletët e punës, mjetet e klasës dhe gjeneruesit me AI, përdorim një numër të vogël API-sh të palëve të treta për shpërndarjen e përmbajtjes, pagesat dhe email-in. Kjo faqe e dokumenton në detaje çdo integrim, në mënyrë që partnerët e platformës (Pinterest, Stripe, Google, Resend, Supabase) dhe vetë përdoruesit tanë të mund të verifikojnë çfarë dërgojmë dhe çfarë marrim.

Pinterest API

Përdorim API-në e Pinterest (v5) për të publikuar automatikisht pin-e të fletëve të punës falas në bordet e Pinterest në pronësi të KiwiBee, në mënyrë që mësuesit t'i zbulojnë burimet tona drejtpërdrejt nga kërkimi në Pinterest.

Të dhënat që dërgojmë

• Titulli i fletës së punës (p.sh. «Mbledhja brenda 20 — Klasa 1»)
• Përshkrimi i fletës së punës (një përmbledhje e shkurtër që administratori shkroi gjatë ngarkimit)
• URL-ja e imazhit paraprak (e hostuar publikisht në CDN-në tonë Supabase Storage)
• Lidhja e destinacionit që të çon te faqja e detajeve të fletës së punës në kiwibee.io
• Etiketat e lëndës dhe të klasës, të përdorura vetëm për të zgjedhur bordin e duhur të destinacionit

Të dhënat që marrim

• ID-ja e pin-it dhe ID-ja e bordit, të ruajtura vetëm që të mund të auditojmë çfarë kemi publikuar
• Header-at e kufizimit të kërkesave të API-së (standarde)

Ndikimi te mësuesit

Mësuesit nuk i lidhin llogaritë e tyre Pinterest me KiwiBee. Integrimi punon vetëm me bordet e Pinterest në pronësi të KiwiBee — pa akses në Pinterest në nivel përdoruesi, pa lexim profilesh, pa lista ndjekësish dhe pa u paraqitur në emër të askujt.

Mundësia për të hequr dorë

Fletët e punës të ngarkuara nga administratori i KiwiBee publikohen si pin vetëm kur një administrator e zgjedh këtë. Burimet e ngarkuara nga komuniteti nuk publikohen kurrë automatikisht si pin. Nëse dëshironi që një fletë pune e caktuar e KiwiBee të hiqet nga Pinterest, na shkruani në hello@kiwibee.io dhe do ta fshijmë pin-in brenda 7 ditëve.

Fushëveprimet OAuth (scopes): Fushëveprimet OAuth të kërkuara: pins:read, pins:write, boards:read. Nuk kërkojmë user_accounts:read, user_followers:read apo ndonjë fushëveprim për borde private.

Stripe API

Përdorim API-në e Stripe për të përpunuar përmirësimin opsional në Standard ose Premium, që faturohet për çdo nxënës të licencuar sipas tarifës për nxënës të publikuar nga KiwiBee, me minimum 30 nxënës. Stripe ruan dhe përpunon informacionin e pagesës; KiwiBee nuk i sheh kurrë të dhënat e papërpunuara të kartës.

Të dhënat që dërgojmë

• Adresa e email-it e mësuesit (për ta lidhur me regjistrin e klientit në Stripe)
• ID-ja e paketës së abonimit në KiwiBee (Standard ose Premium), tarifa për nxënës dhe numri i zgjedhur i nxënësve të licencuar
• Një ID klienti e lëshuar nga Stripe, e ruajtur në profilin KiwiBee të mësuesit

Të dhënat që marrim

• Statusi i abonimit (active, past_due, canceled)
• Ngjarje webhook kur ndryshon statusi
• Mandatpagesat dhe faturat, që Stripe ia dërgon drejtpërdrejt mësuesit

Ndikimi te mësuesit

Stripe është në përputhje me PCI-DSS dhe trajton të gjitha të dhënat e ndjeshme të pagesës. KiwiBee nuk i sheh dhe nuk i ruan kurrë numrat e kartave, kodet CVC apo të dhënat bankare. Mësuesit e menaxhojnë abonimin e tyre (përditësimi i kartës, anulimi) tërësisht brenda Customer Portal të Stripe.

Google OAuth (ofrues i Supabase Auth)

Nëse një mësues zgjedh «Hyr me Google» në vend të lidhjes magjike me email, përdorim Google OAuth përmes Supabase Auth për të verifikuar identitetin e tij.

Të dhënat që dërgojmë

• Sfida standarde OAuth (pa të dhëna përdoruesi të KiwiBee)

Të dhënat që marrim

• Email-i i llogarisë Google + emri i shfaqur + URL-ja e avatarit
• Një ID e qëndrueshme përdoruesi Google, e përdorur vetëm për ta njohur mësuesin kur rikthehet

Ndikimi te mësuesit

Nuk marrim kurrë kontakte, kalendarë, përmbajtje nga Drive apo çfarëdo të dhëne tjetër nga Google — vetëm profilin bazë OpenID. Hyrja me Google është opsionale; hyrja me lidhje magjike me email nuk kërkon fare të dhëna nga Google.

Resend API (email transaksionale)

Përdorim Resend për të dërguar email transaksionale: kodet e hyrjes me lidhje magjike, konfirmimet e llogarisë, mandatpagesat dhe njoftimet për abonimin. Resend shërben si releja jonë SMTP.

Të dhënat që dërgojmë

• Adresa e email-it e marrësit
• Subjekti + përmbajtja e email-it (tekst i thjeshtë dhe HTML)

Të dhënat që marrim

• Statusi i dorëzimit (dërguar, kthyer mbrapsht, hapur — kur ndiqet)

Ndikimi te mësuesit

Resend përpunon vetëm përmbajtjen e email-eve që dërgojmë ne, kurrë email-et hyrëse apo librat e adresave. Mësuesit mund të çabonohen nga çdo email marketingu; email-et transaksionale të hyrjes / faturimit dërgohen vetëm si përgjigje ndaj veprimeve të tyre.

Supabase (vërtetimi, ruajtja, baza e të dhënave)

Supabase strehon llogaritë e mësuesve, shkarkimet e fletëve të punës dhe historikun e gjenerimeve me AI. Të gjitha të dhënat ndodhen në projektin tonë të dedikuar në Supabase.

Të dhënat që dërgojmë

• Profili i mësuesit (email-i, shteti, klasat ku jep mësim, lëndët)
• Regjistrimet e shkarkimeve (ID-ja e fletës së punës, data dhe ora) për zbatimin e kuotës
• Regjistrimet e gjenerimeve me AI (kërkesat dhe rezultatet që krijoni)

Ndikimi te mësuesit

Mësuesit mund të kërkojnë eksportimin ose fshirjen e të gjitha të dhënave të tyre në hello@kiwibee.io. Fshirja e llogarisë fshin në kaskadë të gjitha shkarkimet, gjenerimet me AI dhe të dhënat e profilit.

Pyetje ose kërkesa për të dhënat

Nëse keni ndonjë pyetje për mënyrën si i përdorim këto API, ose dëshironi të kërkoni aksesin, eksportimin, korrigjimin ose fshirjen e të dhënave tuaja, na kontaktoni në hello@kiwibee.io.