Ugrás a fő tartalomhoz

Próbálja ki a bővítmények fejlesztői API-ját

Használd ezt az útmutatót, ha Chastify bővítményt szeretnél létrehozni, iframe bővítményoldalt üzemeltetni, vagy a fejlesztői API-t a saját háttérrendszeredből szeretnéd meghívni.

Ez az oldal a kiindulópont: milyen módot válasszunk, mit hívjunk először, és hová menjünk ezután.

A konkrét bővítmény-viselkedésekről, például a blokkolók feloldásáról, a szokásos kötelező műveletekről, a jutalmakról és a büntetésekről lásd: Bővítmény API-funkciók.

tanács

Csak a saját záradat szeretnéd irányítani?

Ha nincs szükséged nyilvános bővítmény létrehozására, a Külső API és programok oldal a legegyszerűbb módja az indulásnak. Csak létre kell hoznod egy DEV tokent, és meg kell hívnod az egyszerű REST végpontokat – nincs szükség bővítmény beállítására, iframe-re vagy munkamenet-kezelésre. Támogatja az idő hozzáadását/eltávolítását, a befagyasztást, a feladatokat, az eszközparancsokat és egyebeket.

Mire való ez az API?​

Az Extensions Developer API lehetővé teszi harmadik féltől származó bővítményélmények létrehozását, amelyek Chastify zárolási munkameneteken belül futnak.

Ezzel a következőket teheti:

  • Munkamenet- és zárolási kontextus olvasása (session.get bővítményekhez, /api/apps/v1/session saját zárolási automatizáláshoz)
  • Bővítmény tulajdonában lévő adatok olvasása zárolási munkamenetenként (state.get) és írása a háttérrendszerből (PUT/PATCH /state)
  • Bővítmény által tulajdonolt képfájlok tárolása Chastify által felügyelt R2 tárolóban (files.*)
  • Bővítmény felhasználói felületének műveleteinek hozzáadása zárkártyákhoz (metadata.homeActions)
  • Kapu feloldási folyamata bővítmény tulajdonában lévő feloldási blokkolókkal (metadata.unlockBlockers)
  • Zárolási műveletek indítása megbízható háttérrendszerből (idő hozzáadása/eltávolítása, lefagyasztás/feloldás, beállítások javítása)
  • Feladat- és higiéniai műveletek indítása (task.assign, task.start_timer, task.complete, hygienic_unlock.start)
  • Rendszeres műveletek beküldése számlálókkal/ütemtámogatással
  • Küldje el a támogatott eszközparancsokat, ha elérhetők
  • Egyéni bővítménynapló-bejegyzések írása a zárolási előzményekhez

Amit építhetsz​

A megfelelő funkciókészlet attól függ, hogy hol él a bizalom.

A csak a frontendhez tartozó iframe-bővítmények olyan felhasználói felületet teremthetnek, amelyhez nincs szükség megbízható zárolási mutációra:

  • Bővítménykonfigurációt gyűjtő oldalak beállítása
  • Munkamenet-kontextust olvasó irányítópultok
  • Rejtvény-, ellenőrzőlista- vagy játék felhasználói felületek, amelyek beolvassák a munkamenet állapotát, és ellenőrzött előrehaladást küldenek egy háttérrendszeren keresztül
  • Médiaalapú folyamatok, amelyek a Chastify által már tárolt bővítményfájlokat olvassák
  • Kezdőlapi műveleti belépési pontok, amelyek egy szándékkal nyitják meg az iframe-et

A szerveroldali bővítmények zárolást befolyásoló funkciókat hozhatnak létre, mivel a háttérrendszer ellenőrzi az eredményeket a privilegizált API-k meghívása előtt:

  • Feloldási követelményekkel rendelkező feladat- vagy szokásrendszerek
  • Napi vagy heti követelmények ütemezett kihagyott időszak büntetésekkel
  • Játékok, amelyek a sikert jutalmazzák vagy a kudarcot büntetik a zárolási idő módosításával
  • A szerveroldali ellenőrzés után feloldó blokkolókat feloldó ellenőrzési folyamatok
  • Eszközvezérlési kísérőfolyamatok támogatott eszközparancsok használatával
  • Webhook/adatbázis munkafolyamatok, amelyek a kiterjesztés állapotát az iframe-en kívül tartják

A külső programok a saját aktív zárad privát automatizálására szolgálnak:

  • Helyi szkriptek
  • Személyes irányítópultok
  • Felhasználói szintű DEV kulcsot használó automatizálási eszközök

Válassza ki a módját​

Válasszon az alábbi módok közül:

  1. Hosted iframe extension: statikus iframe felhasználói felületet kell üzemeltetni a Cloudflare Pages vagy hasonló szolgáltatásban. A hidat kell használni a beállításhoz, a munkamenet kontextusához és a biztonságos olvasáshoz. Ne használja ezt a módot önmagában állapotíráshoz, jutalmazáshoz, büntetésekhez, feloldási befejezéshez vagy megbízható követelmények előrehaladásához.
  2. Server-backed extension: Hosztold az iframe felhasználói felületét és futtasd a saját backendedet. Az iframe elküldi az indító mainToken kódot a backendednek, és a backend meghívja a Chastify Extension API-t egy alkalmazás-hatókörű fejlesztői API kulccsal és x-chastify-main-token kóddal. Ezt a módot használd privilegizált műveletekhez, blokkolók feloldásához, megbízható előrehaladáshoz, jutalmakhoz, büntetésekhez, webhookokhoz és külső adatbázisokhoz.
  3. External API & Programs: Használjon felhasználószintű DEV kulcsot szkriptekhez, helyi programokhoz vagy automatizálásokhoz, amelyek a saját aktív zárolását vezérlik. Ez a mód nem használható harmadik féltől származó felhasználók számára a bővítmény telepítéséhez.

Ha gyorsan tesztelsz, kezdd az iframe móddal a felhasználói felülethez és a biztonságos olvasáshoz. Add hozzá a backendet, mielőtt megvalósítod az állapotírásokat, a megbízható jutalmakat, az időbeli változtatásokat, az ütemezett követelmény előrehaladását vagy a feloldásblokkoló befejezését.

figyelem

Az iframe kód nem megbízhatósági határ. Bármi, ami látható az iframe-ben, beleértve a hash hasznos adatokat és az indítási tokeneket, a felhasználó által ellenőrizhető és visszajátszható.

Első 10 perc (Iframe mód)​

  1. location.hash hasznos adat beolvasása a ZXQTER0ZXQ iframe megnyitásából.
  2. Hozz létre egy hídkérést a session.get kódhoz.
  3. Erősítse meg a választ a type: "chastify:ext:resp" és a ok: true kóddal.
  4. A tesztállapot a state.get kóddal olvasható.
  5. Automatikus átméretezés + téma támogatás hozzáadása, hogy az iframe megfelelően viselkedjen a felhasználói felületen.

A tématámogatás egy éles használatra kész iframe része. A Chastify átadja a ui értékeket az indítási hash-ben, és élő témafrissítéseket küld, amíg az iframe meg van nyitva. A világos/sötét példákat és a kontrasztbiztos Tailwind mintákat lásd az Iframe Theming dokumentumban.

Szükséges hasznos teher értékek:

  • bridge.nonce
  • bridge.parentOrigin
  • sessionId
  • lockId

Példa hídkérelemre:

{
  "type": "chastify:ext:req",
  "v": 1,
  "id": "request-id", // unique id per request
  "nonce": "nonce-from-hash",
  "action": "session.get",
  "payload": {}
}

Példa híd válaszára:

{
  "type": "chastify:ext:resp",
  "v": 1,
  "id": "request-id",
  "ok": true,
  "data": {}
}

Először megtanulandó alapvető tevékenységek​

  • session.get
  • state.get
    Bővítmény tulajdonában lévő JSON-tárhely beolvasása a zárolási munkamenethez. Állapot kiírása a háttérrendszerből fejlesztői API-hitelesítő adatokkal.
  • files.capabilities, files.list, files.get Használjon fájltároló-olvasási kódot bináris adathordozókhoz, például puzzle-képekhez vagy generált előnézetekhez. Tárolja a fájlazonosítókat háttérben írt állapotban, majd frissítse az aláírt URL-eket files.get kóddal.
  • metadata.get Zárolási munkamenet feloldási blokkolók és bővítménykártya kezdőlapjának műveletei/szándékai olvasása.
  • regularActions.get

A munkamenet-mutációkat, mint például az állapotírásokat, a szokásos műveletek beküldését, a futásidejű fájlok feltöltését/törlését, az időváltozásokat, a blokkoló frissítések feloldásának feloldását, a feladat befejezését, a higiéniai indításokat és az eszközparancsokat a háttérrendszerből kell meghívni egy fejlesztői API-kulccsal. A böngésző iframe-kódja nem megbízható ezeknél a műveleteknél.

Teljes API URL-ek (Támogatott)​

Alap domain: https://chastify.net

Bővített munkamenet API-k (/api/extensions/*)​

Ezeknek az útvonalaknak eltérő hozzáférési módjaik vannak. Ne kezelje a teljes /api/extensions/* felületet iframe-biztosként.

A biztonságos iframe híd útvonalak a Chastify szülőn keresztül kerülnek továbbításra a postMessage hídkérelmek után:

  • GET https://chastify.net/api/extensions/sessions/:sessionId
  • GET https://chastify.net/api/extensions/sessions/:sessionId/state
  • GET https://chastify.net/api/extensions/sessions/:sessionId/metadata
  • GET https://chastify.net/api/extensions/sessions/:sessionId/regular-actions
  • GET https://chastify.net/api/extensions/sessions/:sessionId/files/capabilities
  • GET https://chastify.net/api/extensions/sessions/:sessionId/files
  • GET https://chastify.net/api/extensions/sessions/:sessionId/files/:fileId

A csak háttérben futó telepített bővítmények útvonalaihoz alkalmazásszintű fejlesztői API-kulcs és iframe indítási token szükséges:

Authorization: Bearer YOUR_APP_SCOPED_DEVELOPER_KEY
x-chastify-main-token: MAIN_TOKEN_FROM_IFRAME_HASH
információ

Ez a két tokenes modell egy háttérkérést köt mind a bővítmény fejlesztőjéhez (Authorization), mind az aktuálisan megnyitott bővítmény munkamenethez (x-chastify-main-token).

  • PATCH https://chastify.net/api/extensions/sessions/:sessionId/metadata
  • PUT https://chastify.net/api/extensions/sessions/:sessionId/state
  • PATCH https://chastify.net/api/extensions/sessions/:sessionId/state
  • PATCH https://chastify.net/api/extensions/sessions/:sessionId/regular-actions/config
  • POST https://chastify.net/api/extensions/sessions/:sessionId/regular-actions
  • POST https://chastify.net/api/extensions/sessions/:sessionId/files
  • DELETE https://chastify.net/api/extensions/sessions/:sessionId/files/:fileId
  • POST https://chastify.net/api/extensions/sessions/:sessionId/logs/custom
  • POST https://chastify.net/api/extensions/sessions/:sessionId/notifications/custom
  • POST https://chastify.net/api/extensions/sessions/:sessionId/device-command
  • POST https://chastify.net/api/extensions/sessions/:sessionId/action
  • POST https://chastify.net/api/extensions/sessions/:sessionId/requirements/progress

Háttérbeli token API-k (/api/apps/v1/*)​

Használja a Authorization: Bearer <user-wide DEV token> kódot. Ezek a végpontok a token tulajdonosának saját aktív zárolási munkameneteit kezelik, és külső API szkriptekhez/programokhoz készültek, nem pedig telepített harmadik féltől származó bővítmény-munkamenetekhez.

  • GET https://chastify.net/api/apps/v1/session
  • GET https://chastify.net/api/apps/v1/state
  • PUT https://chastify.net/api/apps/v1/state
  • PATCH https://chastify.net/api/apps/v1/state
  • GET https://chastify.net/api/apps/v1/metadata
  • PATCH https://chastify.net/api/apps/v1/metadata
  • POST https://chastify.net/api/apps/v1/action
  • POST https://chastify.net/api/apps/v1/lock/apply-time
  • POST https://chastify.net/api/apps/v1/lock/freeze
  • POST https://chastify.net/api/apps/v1/lock/unfreeze
  • POST https://chastify.net/api/apps/v1/logs/custom

Iframe Bridge parancsok​

A híd parancsok hasznos adatait iframe (chastify:ext:req) küldi, és a Chastify szülő irányítja. A híd szándékosan a biztonságos/munkamenetes felhasználói felület műveletekre van korlátozva.

  • session.get -> GET https://chastify.net/api/extensions/sessions/:sessionId
  • state.get -> GET https://chastify.net/api/extensions/sessions/:sessionId/state
  • files.capabilities -> GET https://chastify.net/api/extensions/sessions/:sessionId/files/capabilities
  • files.list -> GET https://chastify.net/api/extensions/sessions/:sessionId/files
  • files.get -> GET https://chastify.net/api/extensions/sessions/:sessionId/files/:fileId { "fileId": "file_record_id" }-val
  • metadata.get -> GET https://chastify.net/api/extensions/sessions/:sessionId/metadata
  • regularActions.get -> GET https://chastify.net/api/extensions/sessions/:sessionId/regular-actions

A munkamenet-mutációs végpontok közvetlen háttér-API-hívások, nem iframe bridge parancsok. Ez magában foglalja az állapotírásokat, a szokásos műveletek beküldését és a futásidejű fájlok feltöltését/törlését, mivel az iframe kódot a felhasználó vezérelheti.

Háttérmunkamenet API példák​

A háttérrendszernek mindkét fejlécet el kell küldenie az installed-extension privilegizált hívásokhoz:

Authorization: Bearer YOUR_APP_SCOPED_DEVELOPER_KEY
x-chastify-main-token: MAIN_TOKEN_FROM_IFRAME_HASH

Háttérműveletek példái:

  • metadata.patch -> PATCH /api/extensions/sessions/:sessionId/metadata
  • regularActions.submit -> POST /api/extensions/sessions/:sessionId/regular-actions
  • files.upload -> POST /api/extensions/sessions/:sessionId/files
  • files.delete -> DELETE /api/extensions/sessions/:sessionId/files/:fileId
  • lock.applyTime -> POST /api/extensions/sessions/:sessionId/action { "name": "add_time", "params": <deltaSeconds> }-val
  • lock.freeze -> POST /api/extensions/sessions/:sessionId/action { "name": "freeze", "params": { "durationSeconds": 900 } }-val
  • lock.unfreeze -> POST /api/extensions/sessions/:sessionId/action { "name": "unfreeze", "params": {} }-val
  • lock.settings.patch -> POST /api/extensions/sessions/:sessionId/action { "name": "settings.patch", "params": { ... } }-val
  • task.assign -> POST /api/extensions/sessions/:sessionId/action
  • task.start_timer -> POST /api/extensions/sessions/:sessionId/action { "name": "task.start_timer", "params": {} }-val
  • task.complete -> POST /api/extensions/sessions/:sessionId/action { "name": "task.complete", "params": { "successful": true } }-val
  • hygienic_unlock.start -> POST /api/extensions/sessions/:sessionId/action { "name": "hygienic_unlock.start", "params": { "durationSeconds": 900 } }-val
  • pillory.end -> POST /api/extensions/sessions/:sessionId/action { "name": "pillory.end", "params": {} }-val
  • device.command -> POST /api/extensions/sessions/:sessionId/device-command
  • logs.custom -> POST /api/extensions/sessions/:sessionId/logs/custom
  • notifications.custom -> POST /api/extensions/sessions/:sessionId/notifications/custom
  • requirements.progress -> POST /api/extensions/sessions/:sessionId/requirements/progress

Token, hatókör, visszavonás és auditálási viselkedés​

Használja a megfelelő tokent a megfelelő megbízhatósági határhoz.

vigyázat

A fejlesztői API-kulcsok titkosak. Ha böngészőkódhoz kerülnek, azonnal vond vissza, és cseréld le a háttér környezeti változóját.

Iframe indítási token (mainToken)​

  • Az iframe hash-ben kerül kézbesítésre, amikor a felhasználó megnyit egy telepített bővítmény oldalát.
  • Böngésző által látható. Azonosítja a megnyitott bővítmény-munkamenetet, de nem egy háttérbeli titkos kód.
  • Rövid életű. A jelenlegi indítási tokenek 10 óra elteltével lejárnak; frissítse a bővítmény oldalának újbóli megnyitásával.
  • Kötelező x-chastify-main-token-ként megadni, amikor a háttérrendszer meghívja az installed-bővítmény munkamenet-útvonalait, így a Chastify kötni tudja a háttérrendszer-kérést a bővítményt megnyitó felhasználóhoz/munkamenethez.
  • Önmagában nem használható időmódosítások engedélyezéséhez, blokkoló befejezésének feloldásához, feladat befejezéséhez, eszközparancsokhoz, futásidejű feltöltéshez/törléshez, egyéni naplókhoz vagy egyéni értesítésekhez.

Alkalmazás-hatókörű fejlesztői API-kulcs​

  • Egyetlen bővítményalkalmazás fejlesztői felhasználói felületéről készült.
  • Csak a háttérrendszerben használható titkos kód. Soha ne tedd iframe JavaScriptbe, mobilalkalmazás-csomagokba, statikus tárhelykonfigurációba vagy böngésző által olvasható naplókba.
  • Authorization: Bearer YOUR_APP_SCOPED_DEVELOPER_KEY és x-chastify-main-token kódokkal használatos.
  • Csak olyan munkamenetek esetén hívható meg a telepített bővítmény munkamenet API-ja, amelyek megegyeznek a bővítményalkalmazással és az indítási tokennel.
  • Nem jár le automatikusan. Azonnal vond vissza, ha nyilvánosságra kerül, és cseréld le a háttér környezeti változódat.

Felhasználói szintű fejlesztői API-kulcs​

  • A fejlesztői felhasználói felületről létrehozva, bővítményalkalmazás kiválasztása nélkül.
  • Csak a háttérben használható titkos kód a /api/apps/v1/*-hoz.
  • A kulcs tulajdonosának saját aktuális/jövőbeli aktív zárolási munkameneteit szabályozza.
  • Nem használható telepített harmadik féltől származó bővítmény háttérbeli hitelesítő adataként.

Visszavonás​

  • A visszavont fejlesztői API-kulcsok nem engedélyezik az új kéréseket.
  • A visszavont kulcsok véglegesen törölhetők a fejlesztői felhasználói felületről.
  • Az új iframe-indítások új indítási tokeneket kapnak. Ne tárolja a mainToken kódot hosszú távú hitelesítő adatként.

Hatókörök és szerepkörök​

  • A bővítményalkalmazás-hatókörök leírják, hogy mit kérhet az alkalmazás.
  • A biztonságos iframe hídhívások a felhasználói felület bootstrapjára, munkamenet-olvasásra, bővítmény által birtokolt állapotra, metaadat-olvasásra, normál művelet-olvasásra és fájl-olvasásra korlátozódnak.
  • A privilegizált telepítési munkamenet-mutációkhoz háttérbeli hitelesítő adatok szükségesek, még akkor is, ha a bővítmény egyező hatókörrel rendelkezik.
  • A szerepkör-érzékeny műveletek továbbra is elutasíthatók attól függően, hogy az indítás a viselőhöz vagy a kulcsbirtokoshoz tartozik-e.

Audit és korlátok​

  • A fejlesztői API-kulcs utoljára használt metaadatai frissülnek, amikor a kulcsokat használják.
  • A privilegizált műveleti útvonalak sebességkorlátozottak, és explicit hibákat adnak vissza, például server_credentials_required vagy user_wide_dev_key_required, ha rossz hitelesítőadat-típust használnak.
  • Az egyéni naplók látható zárolási előzményeket írnak.
  • Az egyéni értesítések Chastify értesítéseket hoznak létre a kért célhoz.
  • Minden privilegizált bővítménymutáció teljes auditálási lefedettségét éles környezeti megerősítési elemként követjük nyomon.

Támogatott parancsértékek​

/api/extensions/sessions/:sessionId/action és /api/apps/v1/action​

A name támogatja a következőket:

  • add_time
  • remove_time
  • freeze
  • pillory
  • unfreeze
  • toggle_freeze
  • settings.patch
  • task.assign
  • task.start_timer
  • task.complete
  • hygienic_unlock.start
  • pillory.end

Műveleti korlátok:

  • A Feladatműveletekhez engedélyezni kell a Feladatok bővítményt/modult a zároláson.
  • A hygienic_unlock.start azonosítóhoz engedélyezni kell a higiénikus nyitást, és nincs aktív higiéniai munkamenet.

session.get zárolási adatsegítők​

A session.get / GET /api/apps/v1/session tartalmazza a lockData kódot is, amely futásidejű logikai értékeket, számokat és karakterláncokat tartalmaz a szabálymotorokhoz.

Példák:

  • logikai értékek: frozen, unlockable, trusted, taskAssigned (true, ha létezik egy nyitott TaskRun)
  • számok: timeLockedSeconds, timeRemainingSeconds, maxTimeRemainingSeconds, taskPoints
  • karakterláncok: lockTitle, viselő/kulcstulajdonos profilmezők

Magánélet:

  • A wearerLastSeenTimestamp és a keyholderLastSeenTimestamp kódok null kóddá alakulnak, amikor a felhasználó letiltotta az online állapotot (showOnlineStatus === false).

Eszközparancsok​

A kiterjesztett munkamenetek használhatják a munkamenet-alapú végpontot:

POST /api/extensions/sessions/:sessionId/device-command

A DEV tokennel rendelkező külső programok használhatják az egyszerűbb v1 végpontot (nincs szükség munkamenet-azonosítóra):

POST /api/apps/v1/device-command

Mindkettő ugyanazt a kérés törzsét fogadja el és ugyanazt a választ adja vissza. A részletekért lásd a Külső API és programok leírást.

Beállítási oldal (opcionális, ajánlott)​

Ha a bővítményednek van beállító/konfiguráló felhasználói felülete:

  1. A szülő elküldi a chastify:ext:setup:init kódot (mentett konfiguráció + kontextus).
  2. A beállítási iframe a chastify:ext:setup:config kóddal rendelkező frissítéseket adja vissza.
  3. A szülő a chastify:ext:setup:get_config kóddal kérheti le az aktuális konfigurációt.

Háttérbeli tokenfolyamat (amikor szerveroldali hívásokra van szükség)​

Egyszerű szkriptek és külső programok esetén használjon egy felhasználószintű DEV tokent a fejlesztői API oldalról. Lásd: Külső API és programok.

Alapértelmezett folyamat kiterjesztés iframe módban:

  1. A Chastify egy rövid életű, böngésző által látható indítási tokent bocsát ki az aktív bővítmény-munkamenethez.
  2. Az indítási token mainToken néven van beágyazva az iframe hash hasznos adatba.
  3. Az iframe továbbítja a mainToken kódot a backend rendszernek.
  4. A backend a https://chastify.net/api/extensions/sessions/:sessionId/* függvényt a Authorization: Bearer <app-scoped Developer API key> és x-chastify-main-token: <mainToken> függvényekkel hívja meg.

Ne küldjön fejlesztői API-kulcsokat iframe-be/böngészőkódba. A mainToken azonosítja a megnyitott bővítmény-munkamenetet; nem háttérbeli titkos kód, és önmagában nem használható privilegizált műveletekhez.

Manuális tartalék:

  • Ha explicit módon, a saját felhasználói felületről kell lekérned/elforgatnod az iframe indítási tokent, hívd meg a GET https://chastify.net/api/extensions/sessions/:sessionId/auth függvényt.

Használj háttér módot, ha ütemezett feladatokra, webhookokra vagy automatizálásra van szükséged, miközben a Chastify oldal nincs megnyitva. Az aktuális telepített bővítmény munkamenet-mutációkhoz továbbra is érvényes 10 órás iframe indítási token szükséges, így a felügyelet nélküli feladatoknak tárolniuk kell a függőben lévő bizonyítékot, és a következő érvényes indításkor be kell küldeniük, kivéve, ha háttérben történő végrehajtásra tervezett, saját féltől származó/beépített szerverfolyamatot használsz.

információ

Teljesen felügyelet nélküli éles működéshez előnyben kell részesíteni egy beépített/elsődleges szerverfolyamatot, vagy várni kell a háttérben elérhető explicit bővítményekre. Az alkalmazás hatókörén belüli munkamenet-API-k jelenleg indítási tokenhez kötöttek.

Backend vs Cloudflare oldalak (szerver nélkül)​

Használja a Cloudflare Pages-t (háttérszerver nélkül), ha:​

  • A legegyszerűbb és legolcsóbb beállítást szeretnéd (ingyenesen tárhelyszolgáltatással is elérhető).
  • Csak akkor van szükség felhasználói felület által vezérelt műveletekre, amikor a felhasználó aktívan a bővítmény oldalán van.
  • Nincs szükség kiszolgáló által megőrzött bővítményállapot-írásokra.
  • Gyorsan prototípust készítesz vagy könnyűsúlyú bővítményeket építesz.

Helyi tesztelési példa (PowerShell):

cloudflared tunnel --url http://localhost:5174

A tesztelés során a létrehozott nyilvános URL-címet iframe URL-címként használd.

Használjon háttérszervert, ha:​

  • Ütemezett feladatokra van szükséged (cron-szerű viselkedés).
  • Webhookokra vagy külső integrációkra van szükséged.
  • Automatizálásra/háttérfeldolgozásra van szükséged, amikor senki sincs a bővítmény oldalán.
  • Olyan szerver által vezérelt munkafolyamatokra van szüksége, amelyeknek folyamatosan futniuk kell.

Fontos korlátozás háttérrendszer nélkül:

  • Nincs háttérben futó futtatás. A bővítmény csak akkor hajthat végre műveleteket, ha a felhasználónak éppen meg van nyitva a bővítmény iframe-je, és interakcióba lép vele.

Gyakori problémák​

  • 403 extension_not_enabled: a bővítmény nincs engedélyezve ehhez a zárhoz.
  • 409 lock_ended: a zárolás már nem aktív.
  • 429: elérte a sebességkorlátot.
  • Nincsenek válaszok az iframe-ben: ellenőrizd a nonce, targetOrigin (parentOrigin) értékeket és az engedélyezett eredeteket.

Következő útmutatók​