{"record":{"id":"17a135874a168460","repo":"XTLS/Xray-core","slug":"failed-to-build-api-configuration","errorCode":null,"errorMessage":"failed to build API configuration","messagePattern":"failed to build API configuration","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"infra/conf/xray.go","lineNumber":554,"sourceCode":"\t\t}\n\t}\n\n\tif err := PostProcessConfigureFile(c); err != nil {\n\t\treturn nil, errors.New(\"failed to post-process configuration file\").Base(err)\n\t}\n\n\tconfig := &core.Config{\n\t\tApp: []*serial.TypedMessage{\n\t\t\tserial.ToTypedMessage(&dispatcher.Config{}),\n\t\t\tserial.ToTypedMessage(&proxyman.InboundConfig{}),\n\t\t\tserial.ToTypedMessage(&proxyman.OutboundConfig{}),\n\t\t},\n\t}\n\n\tif c.API != nil {\n\t\tapiConf, err := c.API.Build()\n\t\tif err != nil {\n\t\t\treturn nil, errors.New(\"failed to build API configuration\").Base(err)\n\t\t}\n\t\tconfig.App = append(config.App, serial.ToTypedMessage(apiConf))\n\t}\n\tif c.Metrics != nil {\n\t\tmetricsConf, err := c.Metrics.Build()\n\t\tif err != nil {\n\t\t\treturn nil, errors.New(\"failed to build metrics configuration\").Base(err)\n\t\t}\n\t\tconfig.App = append(config.App, serial.ToTypedMessage(metricsConf))\n\t}\n\tif c.Stats != nil {\n\t\tstatsConf, err := c.Stats.Build()\n\t\tif err != nil {\n\t\t\treturn nil, errors.New(\"failed to build stats configuration\").Base(err)\n\t\t}\n\t\tconfig.App = append(config.App, serial.ToTypedMessage(statsConf))\n\t}\n","sourceCodeStart":536,"sourceCodeEnd":572,"githubUrl":"https://github.com/XTLS/Xray-core/blob/7d214f8b094f75322fa3990f8aadad1c912f24f5/infra/conf/xray.go#L536-L572","documentation":"Error \"failed to build API configuration\" thrown in XTLS/Xray-core.","triggerScenarios":"Thrown at infra/conf/xray.go:554 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"7d214f8b094f75322fa3990f8aadad1c912f24f5","analyzedAt":"2026-08-15T14:26:24.325Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}