Skip to content
This repository was archived by the owner on Aug 15, 2025. It is now read-only.

Commit 86a0d75

Browse files
[bot]update openapi3 schema
1 parent 9560db9 commit 86a0d75

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

api/build/core-openapi3.yaml

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1325,18 +1325,21 @@ components:
13251325
- `export[numbers]` is the word `export` with 20 random digits appended to it
13261326
- `user` is the actors' name
13271327
- `subdomain.example.com` is the FQDN of the server the actor is registered on.
1328-
This file archive contains a file `messages.json` which is a JSON `MessageBatch` of all
1329-
messages sent by the user. Note the [definition of the word "message" in polyproto](https://docs.polyphony.chat/Protocol%20Specifications/core/#:~:text=software%20for%20clients.-,message%2C%20messages,-%3A%20In%20the%20context).
1330-
If the server where the data export was requested from has [RawR](https://docs.polyphony.chat/Protocol%20Specifications/core/#731-resource-addressing-with-relative-roots)
1331-
enabled, the file archive will contain a folder named `rawr`. This folder contains all
1332-
RawR-content uploaded by the actor to that server. The files in this folder are named after
1333-
the resource ID. File extensions are only added if they were known to the server. An
1334-
example file name might be `2c851bfb6daffa944fa1723c7bd4d362ffbc9defe292f2daaf05e895989d179b.jxl`,
1335-
referencing the file which was hosted at `<server_url>/.p2/core/resource/2c851bfb6daffa944fa1723c7bd4d362ffbc9defe292f2daaf05e895989d179b.jxl`.
1328+
This file archive contains a file `messages.p2mb` which is a JSON file containing [message batches](https://docs.polyphony.chat/Protocol%20Specifications/core/#721-message-batches)
1329+
of all messages sent by the user. If the server where the data export was requested from has
1330+
[RawR](https://docs.polyphony.chat/Protocol%20Specifications/core/#731-resource-addressing-with-relative-roots) enabled, the file archive will contain a
1331+
folder named `rawr`. This folder contains all RawR content uploaded by the actor to that server.
1332+
The files in this folder are named after the resource ID given to the resource. File extensions are only
1333+
added if they were known to the server. An example file name might be
1334+
`2c851bfb6daffa944fa1723c7bd4d362ffbc9defe292f2daaf05e895989d179b.jxl`, referencing the file
1335+
which was hosted at `<server_url>/.p2/core/resource/2c851bfb6daffa944fa1723c7bd4d362ffbc9defe292f2daaf05e895989d179b.jxl`.
13361336
If the server where the data export was requested from is the actors' home server, the
1337-
archive will contain two folders `certs` and `crypt_certs`. `certs` will contain all ID-Certs
1338-
the server has stored of the actor. `crypt_certs` will contain all encrypted private key
1339-
material that the actor has uploaded to the server.
1337+
archive will contain a folder `certs` and a file `crypt_certs.p2epk`. `certs` will contain all ID-Certs
1338+
the server has stored of the actor. The ID-Certs will be stored in
1339+
[ASCII PEM format](https://web.archive.org/web/20250107131731/https://learn.microsoft.com/en-us/azure/iot-hub/reference-x509-certificates#:~:text=ASN.1%20encoding.-,ascii%20pem%20format,-A%20PEM%20certificate).
1340+
The file `crypt_certs.p2epk` contains all [encrypted private key material](https://docs.polyphony.chat/Protocol%20Specifications/core/#63-private-key-loss-prevention-and-private-key-recovery)
1341+
that the actor has uploaded to the server. Just like `messages.p2mb`, `crypt_certs.p2epk` is a standard
1342+
JSON file.
13401343
polyproto.core.models.Service:
13411344
type: object
13421345
required:

0 commit comments

Comments
 (0)