You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 15, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: api/build/core-openapi3.yaml
+73-5Lines changed: 73 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -892,6 +892,9 @@ paths:
892
892
- NOT_FOUND
893
893
tags:
894
894
- Resource addressing with relative roots - Registration not required
895
+
security:
896
+
- BearerAuth: []
897
+
- {}
895
898
post:
896
899
operationId: Registered_postResource
897
900
summary: Upload RawR resource
@@ -1087,8 +1090,12 @@ paths:
1087
1090
- BearerAuth: []
1088
1091
/.p2/core/v1/resource/{rid}/info/:
1089
1092
get:
1090
-
operationId: Registered_getResourceInfos
1091
-
summary: Retrieve information about one of your RawR resources
1093
+
operationId: Unregistered_getResourceInfos
1094
+
summary: Retrieve information about a RawR resource
1095
+
description: |-
1096
+
Query the server for information about a RawR resource.
1097
+
This route accepts a Bearer token, but public resources may also be queried without
1098
+
specifying a token.
1092
1099
parameters:
1093
1100
- name: rid
1094
1101
in: path
@@ -1098,7 +1105,12 @@ paths:
1098
1105
type: string
1099
1106
responses:
1100
1107
'200':
1101
-
description: The request has succeeded.
1108
+
description: |-
1109
+
- `200`: Found, contains resource information
1110
+
- `308`: URI root has changed.
1111
+
- `401`: Server or resource requires authentication to access this endpoint.
1112
+
- `403`: Server or resource not accessible for the actor making this request.
1113
+
- `404`: Resource not found.
1102
1114
content:
1103
1115
application/json:
1104
1116
schema:
@@ -1117,18 +1129,69 @@ paths:
1117
1129
- resourceId
1118
1130
- size
1119
1131
- access
1132
+
'308':
1133
+
description: |-
1134
+
- `200`: Found, contains resource information
1135
+
- `308`: URI root has changed.
1136
+
- `401`: Server or resource requires authentication to access this endpoint.
1137
+
- `403`: Server or resource not accessible for the actor making this request.
1138
+
- `404`: Resource not found.
1139
+
headers:
1140
+
Location:
1141
+
required: true
1142
+
schema:
1143
+
type: string
1144
+
format: uri
1145
+
content:
1146
+
application/json:
1147
+
schema:
1148
+
type: string
1149
+
enum:
1150
+
- ROOT_CHANGED
1151
+
'401':
1152
+
description: |-
1153
+
- `200`: Found, contains resource information
1154
+
- `308`: URI root has changed.
1155
+
- `401`: Server or resource requires authentication to access this endpoint.
1156
+
- `403`: Server or resource not accessible for the actor making this request.
1157
+
- `404`: Resource not found.
1158
+
content:
1159
+
application/json:
1160
+
schema:
1161
+
type: string
1162
+
enum:
1163
+
- NEEDS_AUTHENTICATION
1164
+
'403':
1165
+
description: |-
1166
+
- `200`: Found, contains resource information
1167
+
- `308`: URI root has changed.
1168
+
- `401`: Server or resource requires authentication to access this endpoint.
1169
+
- `403`: Server or resource not accessible for the actor making this request.
1170
+
- `404`: Resource not found.
1171
+
content:
1172
+
application/json:
1173
+
schema:
1174
+
type: string
1175
+
enum:
1176
+
- ACCESS_FORBIDDEN
1120
1177
'404':
1121
-
description: The server cannot find the requested resource.
1178
+
description: |-
1179
+
- `200`: Found, contains resource information
1180
+
- `308`: URI root has changed.
1181
+
- `401`: Server or resource requires authentication to access this endpoint.
1182
+
- `403`: Server or resource not accessible for the actor making this request.
1183
+
- `404`: Resource not found.
1122
1184
content:
1123
1185
application/json:
1124
1186
schema:
1125
1187
type: string
1126
1188
enum:
1127
1189
- NOT_FOUND
1128
1190
tags:
1129
-
- Resource addressing with relative roots - Registration required
1191
+
- Resource addressing with relative roots - Registration not required
1130
1192
security:
1131
1193
- BearerAuth: []
1194
+
- {}
1132
1195
/.p2/core/v1/services:
1133
1196
post:
1134
1197
operationId: Registered_registerService
@@ -1809,11 +1872,16 @@ components:
1809
1872
type: object
1810
1873
required:
1811
1874
- private
1875
+
- public
1812
1876
properties:
1813
1877
private:
1814
1878
type: boolean
1815
1879
description: Whether the resource should be private by default. Private resources can only be accessed by the uploader and by instances and actors declared in the `allowlist`.
1816
1880
default: false
1881
+
public:
1882
+
type: boolean
1883
+
description: Whether the resource should be publicly retrievable, i.e. without requiring authentication. If this is `true`, the allow- and denylists are ignored.
0 commit comments