Ikraftträdandedatum: 10 september 2026 Senast uppdaterad: 10 september 2026 Registerversion: 1.0 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.
Arkivet har en rotkatalog vars namn bygger på Applikationen och exportdatumet:
<applikation>-YYYY-MM-DD/
source/**
README.md
percher.toml
env-keys.json
domains.json
deploy-history.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 exportenv-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.
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.
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 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: 10 september 2026* *© 2026 Kaizensu AB — Percher, percher.app*