Esquemas de Configuraciones
La funcionalidad de Schemas define la estructura y los atributos de todas las configuraciones gestionadas por el API. Al proporcionar esquemas detallados para payloads y campos buscables, garantiza la consistencia e integridad de los datos.
El API proporciona tres endpoints de esquema:
GET/settings-objects/schemas: Recupera los esquemas de campos buscables y de payload para todos los tipos de configuración.
GET/settings-objects/{settingType}/examples/payload: Devuelve el esquema de payload específico para un tipo de configuración dado.
GET/settings-objects/{settingType}/examples/searchableFields: Recupera los campos buscables asociados con un tipo de configuración específico.
Cada esquema describe el tipo de datos de cada campo y especifica los campos obligatorios requeridos en el payload.
GET/settings-objects/schemas Ejemplo de respuesta
{
"settings": [
{
"settingType": "testType",
"searchableFieldsSchema": {
"type": "object",
"properties": {
"uniqueId": {
"type": "string"
},
"status": {
"type": "string"
},
"processingEntity": {
"type": "string"
},
"source": {
"type": "string"
},
"id": {
"type": "string"
},
"idList": {
"type": "array",
"items": {
"type": "string"
}
},
"atTime": {
"type": "string",
"format": "date-time"
}
}
},
"payloadSchema": {
"TestSubSetting": {
"required": [
"uniqueId"
],
"type": "object",
"properties": {
"uniqueId": {
"type": "string"
}
}
},
"CommonTestSubSetting": {
"required": [
"uniqueId"
],
"type": "object",
"properties": {
"uniqueId": {
"type": "string"
},
"commonField": {
"type": "string"
}
}
},
"TestSetting": {
"required": [
"testSubSetting",
"testSubSettings",
"uniqueId"
],
"type": "object",
"properties": {
"uniqueId": {
"maxLength": 70,
"minLength": 0,
"type": "string"
},
"anotherField": {
"maxLength": 70,
"minLength": 1,
"pattern": "[0-9A-Z]{11}",
"type": "string"
},
"testSubSetting": {
"$ref": "#/components/schemas/TestSubSetting"
},
"testSubSettings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TestSubSetting"
}
},
"testEnum": {
"type": "string",
"enum": [
"VALUE_1",
"VALUE_2"
]
},
"commonTestSubSetting": {
"$ref": "#/components/schemas/CommonTestSubSetting"
}
}
}
}
}
]
}