trustgraph/specs/api/components/schemas/diag/StructuredDiagResponse.yaml
cybermaggedon fce43ae035
REST API OpenAPI spec (#612)
* OpenAPI spec in specs/api.  Checked lint with redoc.
2026-01-15 11:04:37 +00:00

49 lines
1.2 KiB
YAML

type: object
description: Structured data diagnosis response
required:
- operation
properties:
operation:
type: string
description: Operation that was performed
example: diagnose
detected-type:
type: string
description: Detected data format (for detect-type/diagnose)
enum: [csv, json, xml]
example: csv
confidence:
type: number
description: Detection confidence score (0.0-1.0)
minimum: 0.0
maximum: 1.0
example: 0.95
descriptor:
type: object
description: Generated schema descriptor (for generate-descriptor/diagnose)
additionalProperties: {}
example:
schema_name: person-records
type: csv
fields:
- name: name
type: string
- name: age
type: integer
- name: email
type: string
metadata:
type: object
description: Additional analysis metadata
additionalProperties:
type: string
example:
field_count: "3"
record_count: "2"
has_header: "true"
schema-matches:
type: array
description: Matching schema IDs (for schema-selection)
items:
type: string
example: ["person-schema-v1", "contact-schema-v2"]