Közzététel, felülvizsgálat, telepítés
Egy release életciklusának referenciája. Adminfelületi route-ok, mit küld a közzététel, production és development csatornák, felülvizsgálat, telepítési állapotok, frissítések, eltávolítás és azonosítók.
Ezen az oldalon
Ez az oldal a Kiadás a kereskedőknek referenciadokumentációja. A közzététel és a felülvizsgálat a Poltura adminfelületén történik. A szervezeted nem vizsgálhatja felül a saját appját, a kereskedő pedig mindaddig nem adhat hozzáférést, amíg a Poltura egyik reviewere jóvá nem hagyta pontosan azt a production release-t.
Adminfelületi workspace-ek
| Workspace | Útvonal | Ki |
|---|---|---|
| Fejlesztői appok | /developer/apps | Te (fejlesztői mód) |
| App részletei / feltöltés | /developer/apps/{appId} | Te |
| Kereskedői jóváhagyás | Poltura ID | Boltadminisztrátor |
| Csatlakoztatott appok | /connected-apps | Boltadminisztrátor |
Közzététel
poltura app publish --api "$POLTURA_API" --app <app id> --token "$POLTURA_APP_TOKEN"A poltura app publish lefuttatja a buildet, majd egy multipart POST-kérést küld a {api}/v1/public-apps/apps/{appId}/releases endpointra Authorization: Bearer pltd_… (vagy személyes pltu_…) headerrel. Mezők: manifest, channel, worker:<path>, style:<path>, opcionális extension:<path>. Az alapértelmezett csatorna a production. A --api a Poltura API originje (a POLTURA_API környezeti változóból is beolvasható, alapértelmezés szerint https://api.poltura.com). Az appazonosító és a fejlesztői token egyaránt az adminfelület Fejlesztői appok menüpontjából származik: hozd létre ott az appot, majd hozz létre egy tokent a Developer tokens alatt. A fejlesztői token kizárólag release-ek beküldésére és olvasására használható; soha nem hoz létre appokat, és nem kezeli a szervezetet. Érvényét veszti, ha lejár, visszavonják, vagy ha a létrehozója kilép a fejlesztői szervezetből, vagy elveszíti a publisher szerepkört. Elutasított token esetén a válasz 401 invalid_token vagy 403 permission_denied, egy hivatkozással a hibareferenciára. A közzététel nem használja a poltura login bejelentkezést, az a bolti parancsokhoz való.
CLI nélkül a Fejlesztői appok feltöltési űrlapja ugyanezeket a fájlokat fogadja el. A route-oknak egyezniük kell a manifesttel.
Production és development
| Production | Development | |
|---|---|---|
| Felülvizsgálják | Igen | Igen |
| Ezt a release-t kapják az új telepítések | Igen, jóváhagyás után | Nem |
| Telepíthető | Jóváhagyás után | Soha (release_not_production) |
Felülvizsgálat
A felülvizsgáló látja a jogosultságokat és azok céljait, a backend origint, a hosztolt oldalt (ha van), az átirányítási URL-eket, a manifest digestjeit, minden workert (útvonal, cél, méret és digest), valamint a stylesheetet. Minden döntéshez indoklás tartozik, és pontosan arra a manifestre vonatkozik, amelyet a felülvizsgáló ellenőrzött, így a release nem módosulhat a döntés alatt. A szervezetedből senki sem hagyhatja jóvá a beküldésedet. Egy release állapota submitted, in_review, changes_requested, approved vagy rejected lehet.
Telepítés
A kereskedő a jóváhagyott production release-t a Poltura ID-ban telepíti, és minden jogosultságot a hozzá tartozó purpose szöveggel együtt lát; lásd a Hitelesítés részt.
| Állapot | Webhook |
|---|---|
preparing | csak snapshot |
ready | app.installed |
removing | app.suspended |
removed | app.uninstalled |
A nyilvános állapottípus tartalmazza a needs_setup és needs_attention értékeket is; a telepítések jelenleg nem kerülnek ezekbe az állapotokba.
Egy boltnak a csomagja szabja meg, hány alkalmazása lehet. Az ezen felüli telepítést resource_limit_reached hibával elutasítjuk. Ha egy bolt kerete csökken, és a kereskedő nem szabadít fel helyet időben, a legújabb alkalmazásokat eltávolítjuk, és az alkalmazásod ugyanazokat a webhookokat kapja, mint bármely más eltávolításnál.
Az azonos kéréskulccsal megismételt telepítési kérés a már létrehozott telepítést adja vissza – még az eltávolítottat is –, és soha nem állítja vissza az eltávolított telepítést.
Frissítés
A frissítés megőrzi a telepítésazonosítót. Miután a kereskedő jóváhagyja az új production release-t, a telepítés generation értéke nő, a release-e pedig lecserélődik; a korábban kiadott hozzáférési tokenek 403-as hibát adnak. Minden csatlakozás után tárold el az installation.retrieve() eredményét. Webhook: app.updated.
Eltávolítás
A kereskedő eltávolítja a telepítést. A jogosultságai törlődnek, a generation értéke pedig nő. Egy új telepítés nem férhet hozzá a korábbi telepítés app-tárhelyéhez. Az app eltávolítása nem törli az adatokat a szervereidről; töröld őket, amikor megkapod az app.uninstalled webhookot.
Azonosítók
A Polturától kapott összes azonosító kisbetűs UUIDv7 formátumú, például: 0199f3a2-5b1c-7d4e-9f20-3a4b5c6d7e8f.
Egy azonosító soha nem árulja el, hogy mit jelöl, ezért mindig tartsd együtt azzal a mezővel, amelyben érkezett. Az UUIDv7 azonosítók a létrehozási idejük alapján rendezhetők.
| Azonosító | Jelentés |
|---|---|
appId | Nyilvános appazonosító a Fejlesztői appok felületről |
releaseId | Release ID, a poltura app publish írja ki |
installationId | Telepítésazonosító: a Poltura-Installation header, webhookok, session tokenek |
eventId | Nyilvános eseményazonosító; ezzel deduplikálhatod a kézbesítéseket |
requestId | Nyilvános API-kérésazonosító, minden error body-ban ott van |