{"openapi":"3.1.0","info":{"title":"Electro Oracle API","description":"Deterministic comparison of industrial contactor parameters with field-level evidence. This pilot does not certify a drop-in replacement.","version":"0.5.0-dev"},"paths":{"/.well-known/electro-oracle.json":{"get":{"summary":"Discovery","operationId":"discovery__well_known_electro_oracle_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Discovery  Well Known Electro Oracle Json Get"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/capabilities":{"get":{"summary":"Capabilities","operationId":"capabilities_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Capabilities Capabilities Get"}}}}}}},"/supported-parts":{"get":{"summary":"Supported Parts","operationId":"supported_parts_supported_parts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Supported Parts Supported Parts Get"}}}}}}},"/v1/compare-contactor":{"post":{"summary":"Compare","operationId":"compare_v1_compare_contactor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Application":{"properties":{"control_voltage_v":{"type":"number","exclusiveMinimum":0.0,"title":"Control Voltage V"},"control_current_type":{"$ref":"#/components/schemas/CurrentType"},"control_frequency_hz":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Control Frequency Hz"},"utilization_category":{"type":"string","minLength":1,"title":"Utilization Category","default":"AC-3"},"required_operational_current_a":{"type":"number","exclusiveMinimum":0.0,"title":"Required Operational Current A"},"motor_voltage_v":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Motor Voltage V"},"required_motor_power_kw":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Required Motor Power Kw"},"required_main_poles":{"type":"integer","exclusiveMinimum":0.0,"title":"Required Main Poles","default":3},"required_aux_contacts":{"$ref":"#/components/schemas/RequiredAuxContacts"},"mounting_method":{"anyOf":[{"$ref":"#/components/schemas/MountingMethod"},{"type":"null"}]},"max_dimensions_mm":{"anyOf":[{"$ref":"#/components/schemas/DimensionsMm"},{"type":"null"}]}},"type":"object","required":["control_voltage_v","control_current_type","required_operational_current_a"],"title":"Application"},"ComparisonRequest":{"properties":{"original_part":{"$ref":"#/components/schemas/PartRef"},"candidate_part":{"$ref":"#/components/schemas/PartRef"},"application":{"$ref":"#/components/schemas/Application"}},"additionalProperties":false,"type":"object","required":["original_part","candidate_part","application"],"title":"ComparisonRequest"},"ComparisonResult":{"properties":{"decision":{"type":"string","enum":["compatible_on_verified_parameters","conditional_match","incompatible","insufficient_data"],"title":"Decision"},"coverage":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Coverage"},"catalog_version":{"type":"string","title":"Catalog Version"},"catalog_mode":{"type":"string","enum":["demo","pilot","production"],"title":"Catalog Mode"},"engine_version":{"type":"string","title":"Engine Version"},"original_part":{"$ref":"#/components/schemas/PartSummary"},"candidate_part":{"$ref":"#/components/schemas/PartSummary"},"criteria":{"items":{"$ref":"#/components/schemas/CriterionResult"},"type":"array","title":"Criteria"},"documents":{"items":{"$ref":"#/components/schemas/SourceDocument"},"type":"array","title":"Documents"},"evidence":{"additionalProperties":{"$ref":"#/components/schemas/EvidenceRef"},"type":"object","title":"Evidence"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["decision","coverage","catalog_version","catalog_mode","engine_version","original_part","candidate_part","criteria","documents","evidence","limitations"],"title":"ComparisonResult"},"CriterionResult":{"properties":{"criterion":{"type":"string","title":"Criterion"},"severity":{"type":"string","enum":["blocker","condition","information"],"title":"Severity"},"status":{"type":"string","enum":["match","mismatch","unknown","not_applicable"],"title":"Status"},"original":{"title":"Original"},"candidate":{"title":"Candidate"},"required":{"anyOf":[{},{"type":"null"}],"title":"Required"},"explanation":{"type":"string","title":"Explanation"},"evidence_paths":{"items":{"type":"string"},"type":"array","title":"Evidence Paths"}},"type":"object","required":["criterion","severity","status","original","candidate","explanation"],"title":"CriterionResult"},"CurrentType":{"type":"string","enum":["AC","DC"],"title":"CurrentType"},"DimensionsMm":{"properties":{"width":{"type":"number","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"number","exclusiveMinimum":0.0,"title":"Height"},"depth":{"type":"number","exclusiveMinimum":0.0,"title":"Depth"}},"type":"object","required":["width","height","depth"],"title":"DimensionsMm"},"EvidenceRef":{"properties":{"source_id":{"type":"string","minLength":1,"title":"Source Id"},"page":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Page"},"status":{"type":"string","enum":["verified","conflicting","unknown"],"title":"Status","default":"verified"},"verified_at":{"type":"string","format":"date","title":"Verified At"},"verified_by":{"type":"string","minLength":1,"title":"Verified By"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["source_id","verified_at","verified_by"],"title":"EvidenceRef"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MountingMethod":{"type":"string","enum":["DIN_RAIL","SCREW","PANEL","OTHER"],"title":"MountingMethod"},"PartRef":{"properties":{"manufacturer":{"type":"string","minLength":1,"title":"Manufacturer"},"part_number":{"type":"string","minLength":1,"title":"Part Number"}},"type":"object","required":["manufacturer","part_number"],"title":"PartRef"},"PartSummary":{"properties":{"manufacturer":{"type":"string","title":"Manufacturer"},"family":{"type":"string","title":"Family"},"part_number":{"type":"string","title":"Part Number"}},"type":"object","required":["manufacturer","family","part_number"],"title":"PartSummary"},"RequiredAuxContacts":{"properties":{"normally_open":{"type":"integer","minimum":0.0,"title":"Normally Open","default":0},"normally_closed":{"type":"integer","minimum":0.0,"title":"Normally Closed","default":0}},"type":"object","title":"RequiredAuxContacts"},"SourceDocument":{"properties":{"source_id":{"type":"string","minLength":1,"title":"Source Id"},"manufacturer":{"type":"string","minLength":1,"title":"Manufacturer"},"document_title":{"type":"string","minLength":1,"title":"Document Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"revision":{"type":"string","minLength":1,"title":"Revision"},"retrieved_at":{"type":"string","format":"date","title":"Retrieved At"},"sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Sha256"},"sha256_status":{"type":"string","enum":["captured","not_captured"],"title":"Sha256 Status"}},"type":"object","required":["source_id","manufacturer","document_title","url","revision","retrieved_at","sha256_status"],"title":"SourceDocument"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}