chore: update OpenAPI specs for DocMDP endpoint

Regenerate OpenAPI documentation files to include setDocMdpConfig endpoint:
- openapi-administration.json
- openapi-full.json
- TypeScript type definitions

Generated from updated PHPDoc annotations.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
This commit is contained in:
Vitor Mattos 2025-12-06 18:05:55 -03:00
parent 0b0ed79132
commit a66384c011
No known key found for this signature in database
GPG key ID: 6FECE2AD4809003A
4 changed files with 558 additions and 0 deletions

View file

@ -2815,6 +2815,189 @@
}
}
},
"/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/docmdp/config": {
"post": {
"operationId": "admin-set-doc-mdp-config",
"summary": "Set DocMDP configuration",
"description": "This endpoint requires admin access",
"tags": [
"admin"
],
"security": [
{
"bearer_auth": []
},
{
"basic_auth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"enabled",
"defaultLevel"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Enable or disable DocMDP certification"
},
"defaultLevel": {
"type": "integer",
"format": "int64",
"description": "Default DocMDP level (0-3): 0=none, 1=no changes, 2=form fill, 3=form fill + annotations"
}
}
}
}
}
},
"parameters": [
{
"name": "apiVersion",
"in": "path",
"required": true,
"schema": {
"type": "string",
"enum": [
"v1"
],
"default": "v1"
}
},
{
"name": "OCS-APIRequest",
"in": "header",
"description": "Required to be true for the API request to pass",
"required": true,
"schema": {
"type": "boolean",
"default": true
}
}
],
"responses": {
"200": {
"description": "Configuration saved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid DocMDP level provided",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
}
},
"/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
"get": {
"operationId": "crl_api-list",

View file

@ -11292,6 +11292,189 @@
}
}
},
"/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/docmdp/config": {
"post": {
"operationId": "admin-set-doc-mdp-config",
"summary": "Set DocMDP configuration",
"description": "This endpoint requires admin access",
"tags": [
"admin"
],
"security": [
{
"bearer_auth": []
},
{
"basic_auth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"enabled",
"defaultLevel"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Enable or disable DocMDP certification"
},
"defaultLevel": {
"type": "integer",
"format": "int64",
"description": "Default DocMDP level (0-3): 0=none, 1=no changes, 2=form fill, 3=form fill + annotations"
}
}
}
}
}
},
"parameters": [
{
"name": "apiVersion",
"in": "path",
"required": true,
"schema": {
"type": "string",
"enum": [
"v1"
],
"default": "v1"
}
},
{
"name": "OCS-APIRequest",
"in": "header",
"description": "Required to be true for the API request to pass",
"required": true,
"schema": {
"type": "boolean",
"default": true
}
}
],
"responses": {
"200": {
"description": "Configuration saved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid DocMDP level provided",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"ocs"
],
"properties": {
"ocs": {
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#/components/schemas/OCSMeta"
},
"data": {
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
}
},
"/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
"get": {
"operationId": "crl_api-list",

View file

@ -323,6 +323,26 @@ export type paths = {
patch?: never;
trace?: never;
};
"/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/docmdp/config": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get?: never;
put?: never;
/**
* Set DocMDP configuration
* @description This endpoint requires admin access
*/
post: operations["admin-set-doc-mdp-config"];
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
parameters: {
query?: never;
@ -1501,6 +1521,82 @@ export interface operations {
};
};
};
"admin-set-doc-mdp-config": {
parameters: {
query?: never;
header: {
/** @description Required to be true for the API request to pass */
"OCS-APIRequest": boolean;
};
path: {
apiVersion: "v1";
};
cookie?: never;
};
requestBody: {
content: {
"application/json": {
/** @description Enable or disable DocMDP certification */
enabled: boolean;
/**
* Format: int64
* @description Default DocMDP level (0-3): 0=none, 1=no changes, 2=form fill, 3=form fill + annotations
*/
defaultLevel: number;
};
};
};
responses: {
/** @description Configuration saved successfully */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
message: string;
};
};
};
};
};
/** @description Invalid DocMDP level provided */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
error: string;
};
};
};
};
};
/** @description Internal server error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
error: string;
};
};
};
};
};
};
};
"crl_api-list": {
parameters: {
query?: {

View file

@ -1334,6 +1334,26 @@ export type paths = {
patch?: never;
trace?: never;
};
"/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/docmdp/config": {
parameters: {
query?: never;
header?: never;
path?: never;
cookie?: never;
};
get?: never;
put?: never;
/**
* Set DocMDP configuration
* @description This endpoint requires admin access
*/
post: operations["admin-set-doc-mdp-config"];
delete?: never;
options?: never;
head?: never;
patch?: never;
trace?: never;
};
"/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
parameters: {
query?: never;
@ -5897,6 +5917,82 @@ export interface operations {
};
};
};
"admin-set-doc-mdp-config": {
parameters: {
query?: never;
header: {
/** @description Required to be true for the API request to pass */
"OCS-APIRequest": boolean;
};
path: {
apiVersion: "v1";
};
cookie?: never;
};
requestBody: {
content: {
"application/json": {
/** @description Enable or disable DocMDP certification */
enabled: boolean;
/**
* Format: int64
* @description Default DocMDP level (0-3): 0=none, 1=no changes, 2=form fill, 3=form fill + annotations
*/
defaultLevel: number;
};
};
};
responses: {
/** @description Configuration saved successfully */
200: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
message: string;
};
};
};
};
};
/** @description Invalid DocMDP level provided */
400: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
error: string;
};
};
};
};
};
/** @description Internal server error */
500: {
headers: {
[name: string]: unknown;
};
content: {
"application/json": {
ocs: {
meta: components["schemas"]["OCSMeta"];
data: {
error: string;
};
};
};
};
};
};
};
"crl_api-list": {
parameters: {
query?: {