Ikraftträdandedatum: 11 oktober 2026
Senast uppdaterad: 11 oktober 2026
Registerversion: 1.0.4
API-specifikationsversion: 1.0.0 (OpenAPI 3.1.0)
Detta register utgör en del av Perchers Användarvillkor. Det beskriver gränssnitt för byte, datastrukturer, format, standarder, kända tekniska begränsningar och den infrastrukturinformation som krävs enligt artiklarna 26 och 28 i förordning (EU) 2023/2854 (dataförordningen).
Alla sökvägar nedan använder https://api.percher.run som basadress. "Bearer" betyder en API-token för Percher som tillhör Applikationens ägare. Den maskinläsbara gränssnittsdefinitionen är OpenAPI-specifikationen för Percher.
| Export | Gränssnitt och autentisering | Svarsformat |
|---|---|---|
| Kontoögonblicksbild | GET /account/export — Bearer | JSON-objekt som beskrivs i avsnitt 2 |
| Applikationspaket | POST /apps/{appRef}/export/mint — Bearer; därefter engångsanrop till GET /export/download/{token} där token är nedladdningsbehörigheten | gzip-komprimerat tar-arkiv (.tar.gz) som beskrivs i avsnitt 2 |
| Applikationspaket med värden för Miljövariabler | Applikationsexport i dashboarden — autentiserad webbläsarsession och ny lösenordsbekräftelse; därefter engångsnedladdning | Samma .tar.gz-struktur med de ytterligare filerna för hemliga värden som beskrivs i avsnitt 2. Hemliga värden är inte tillgängliga genom Bearer-autentiserad API-, CLI- eller MCP-export. |
| Kontroll av Git-historik | GET /apps/{appRef}/export/git/check — Bearer, endast ägare | JSON med ok och estimatedBytes |
| Git-historik | GET /apps/{appRef}/export/git — Bearer, endast ägare | Git bundle (application/x-git-bundle, .bundle) |
| Kontroll av PocketBase-ögonblicksbild | GET /apps/{appRef}/data/export/check — Bearer, endast ägare | JSON-status |
| PocketBase-data | GET /apps/{appRef}/data/export — Bearer, endast ägare | gzip-komprimerat tar-arkiv (.tar.gz) av den tillgängliga katalogen pb_data |
Självserviceexport kan starta omedelbart; assisterat byte begärs enligt Villkorens avsnitt 15.6. Destinationsleverantören eller kunden ansvarar för import och drift av Applikationen.
JSON-roten innehåller exportedAt, user, apiTokens, alertPreferences, sharedAccess, apps, supportCases, withdrawalReceipts, dataExportUrls, perAppExports och _note. Applikationsposter innehåller Applikationsposten, deployposter, namn på Miljövariabler och anpassade domäner. API-tokenhemligheter, värden för Miljövariabler och omfattande byggloggar ingår inte; omfattande eller Applikationsspecifika data representeras av autentiserade exporthänvisningar.
Applikationsposter innehåller också iconImageRejectedCode och previewImageRejectedCode (orsakskoder för moderering), samt previewImageOrientation och previewImagePendingOrientation (godkänd respektive väntande förhandsbildsorientering, landscape, portrait eller null). De motsvarar databasfälten icon_image_rejected_code, preview_image_rejected_code, preview_image_orientation och preview_image_pending_orientation. Bildfiler ingår inte i Kontoögonblicksbilden.
apps[].images[] listar uppladdade ikoner och galleriförhandsbilder, även väntande bilder, med file, description, orientation och url. Varje url är en relativ publik nedladdningssökväg (/icons/<appId>/<hash>.<ext>), inte en bearer-autentiserad exportlänk.
Arkivet har en rotkatalog vars namn bygger på Applikationen och exportdatumet:
<applikation>-YYYY-MM-DD/
source/** # när den aktiva driftsättningens källarkiv finns
SOURCE-UNAVAILABLE.txt # annars, orsaken till att källkod saknas
images/icon.<ext> # tillgänglig godkänd ikon
images/icon-pending.<ext> # tillgänglig ikon som väntar på granskning
images/preview.<ext> # tillgänglig godkänd förhandsbild
images/preview-pending.<ext> # tillgänglig förhandsbild som väntar på granskning
images/README.txt # registrerade bilder och tillgänglighet
README.md
percher.toml
env-keys.json
domains.json
deploy-history.json
visitor-statistics.json
visitor-statistics-counters.json
build-logs.json
runtime-logs.json
crash-reports.json
env-values.json # endast efter ny lösenordsbekräftelse
env-values-by-scope.json # endast efter ny lösenordsbekräftelse
pocketbase/schema.json # när automatiserad PocketBase-export är tillgänglig
pocketbase/pb_data.zip # när automatiserad PocketBase-backup är tillgänglig
pocketbase/README.md # annars, instruktioner för manuell exportDen valfria katalogen images/ innehåller de uppladdade bildfiler som finns kvar. images/README.txt anger vilka filer som är godkända eller väntande och förklarar saknade eller ogiltiga filer.
env-keys.json innehåller keys och en kommentar. domains.json innehåller verified. deploy-history.json är en array med objekt som innehåller deployidentifierare, status, typ, commitreferenser, kommentar och tidsstämplar. env-values.json är ett nyckel-/värdeobjekt. env-values-by-scope.json innehåller rows, var och en med key, scope och value. pocketbase/schema.json innehåller det exporterade PocketBase-schemat för collections.
Driftsättningshistoriken innehåller alla bevarade live- och förhandsdriftsättningar, sorterade efter identifierare. Filerna med besöksstatistik innehåller bevarade dagliga aggregat, rankningsräknare och fullständighetsflaggor, inte besökarhashar, salter eller råa HTTP-åtkomstloggar. Byggloggar och kraschrapporter innehåller bevarade poster. Körningsloggar innehåller textdelar från befintliga appcontainrar, inte PocketBase-containrar; sammanfoga varje containers textdelar i arrayordning. Statusposter anger otillgängliga buffertar, undanhållna utdata och slutförda läsningar. Dessa JSON-datamängder har ingen exportgräns för antal poster eller rader och strömmas eller läses sidvis, inte som en transaktionsögonblicksbild.
Git-exporten är den fullständiga historik som är tillgänglig i Perchers repository för Applikationen, i Git bundle-format, och kan verifieras och klonas med Gits egna bundle-kommandon. Den direkta PocketBase-exporten bevarar det tillgängliga katalogträdet pb_data i ett .tar.gz-arkiv för import till en kompatibel PocketBase-installation.
Percher uppdaterar registret när en stödd struktur, ett format eller ett gränssnitt ändras väsentligt. Inget proprietärt importverktyg krävs.
build/, dist/ och out/, bevaras; symboliska och hårda länkar utelämnas av arkivsäkerhetsskäl. Separat genererade byggartefakter och cachar på plattformen ingår inte.max-size=10m och max-file=3 per befintlig appcontainer, utan tidsbaserad lagringsgräns; bufferten försvinner när containern raderas. Kända hemliga värden med minst åtta tecken maskeras i diagnostik; kortare eller oregistrerade värden kan finnas kvar. Utdata undanhålls när den nödvändiga uppsättningen hemligheter inte kan verifieras. Plattformens hanterade autentiseringsuppgifter utesluts ur filer med miljövariabelvärden.Om en självservicegräns hindrar en fullständig export, kontakta support@percher.app för assisterat byte.
Percher drivs av Kaizensu AB i Sverige. Central hosting, lagring och backup hålls inom EES, för närvarande i Tyskland och Finland, och omfattas av EU-rätt och svensk, tysk respektive finsk rätt beroende på drift och plats. Leverantörer och behandlingsplatser anges i Integritetspolicyn och Meddelandet om underbiträden.
För icke-personuppgifter som lagras inom unionen använder Percher EES-baserad central lagring, kontrollerad och loggad administrativ åtkomst, separering mellan kunder, arbetsbelastningar och nätverk, minsta behörighet, kryptering under överföring, kryptering av lagrade hemliga värden och externa backuper, dataminimering, begränsad lagringstid, avtalsgranskning av leverantörer samt granskning av myndighetsbegäranden avseende giltig rättslig grund, omfattning och behörighet. Begäranden avvisas eller bestrids när det är rättsligt tillåtet och rimligen möjligt. Åtgärderna hindrar inte utlämnande som krävs enligt bindande EU-rätt eller medlemsstatsrätt. Överföring av personuppgifter regleras av GDPR, Integritetspolicyn och, i tillämpliga fall, DPA:n.
Frågor om byte, format eller begränsningar: support@percher.app Juridiska frågor och frågor om dataåtkomst: legal@percher.app
Den engelska och den svenska versionen är avsedda att ha samma innebörd. Vid en avvikelse har den engelska versionen företräde, utan att tvingande rättigheter begränsas.
*Senast uppdaterad: 11 oktober 2026*
*© 2026 Kaizensu AB — Percher, percher.app*