{ "Protocol": "AIXE", "Version": "1.0", "Endpoint": "/aixe/business/get-business-info", "DiscoveryRequest": "GET /aixe/business/get-business-info/?", "CanonicalHelpTrigger": "GET /aixe/business/get-business-info/?", "ActionRequest": "POST /aixe/business/get-business-info", "Method": "POST", "ContentType": "application/json; charset=utf-8", "Title": "Get Business Information", "AuthenticationRequired": false, "AccessType": "Public", "Purpose": "Returns the current public business information needed to understand, contact, and order from Knead A Break Treats N\u0027 Eats.", "DocumentationSource": "AIXEEndpointRegistry", "ProtocolReference": { "ProtocolHome": "http://aixeprotocol.com/", "CanonicalUsageContract": "http://aixeprotocol.com/usage/?", "Whitepaper": "http://aixeprotocol.com/whitepaper/full-spec.html", "Inventor": "Gregory Oglethorpe", "IncludeIn": [ "/aixe.ai starter discovery documents", "Every endpoint self-description returned by GET /endpoint/?" ], "AIInstruction": "Read this live endpoint contract as operational guidance, not merely as a transport schema. Use its purpose, field meanings, business rules, outcomes, and recovery guidance to reason about whether and how to perform the capability." }, "UsageGuidance": { "Role": "Use this when a human asks about the business, contact details, hours, tax, pickup, or delivery.", "CorrectWorkflow": [ "Use this when a human asks about the business, contact details, hours, tax, pickup, or delivery.", "Read SuccessCode before using any returned information." ], "DoNotDo": [ "Do not send business variables, keys, filters, or action inputs in the URL or query string.", "Do not infer success from HTTP status alone." ] }, "AIUsageGuidance": { "ContractRole": "This live document teaches an AI what the capability means and how to use it; it is not merely a list of request fields.", "ReasoningInstruction": "Decide whether this capability serves the human\u0027s intent from Purpose and BusinessRules, gather values using each field\u0027s Description and constraints, then interpret the returned SuccessCode before reporting an outcome.", "FieldInstruction": "Field names are transport labels. Their Description, source, constraints, and business meaning explain what information the AI should obtain and why." }, "RequiredFields": {}, "OptionalFields": {}, "BusinessRules": [ "This capability is read-only.", "Internal numeric database identifiers are never returned.", "Enabled pickup or delivery does not confirm a particular fulfillment date or time." ], "ResponseFields": { "SuccessCode": { "Type": "string", "Description": "The authoritative action outcome. SUCCESS means the business information was returned.", "Required": true, "SubmittedIn": "Response body" }, "Business": { "Type": "object", "Description": "The current public Business record, including its public BusinessKey, business name, contact information, address, hours, tax rate, and enabled fulfillment methods.", "Required": true, "SubmittedIn": "Response body" } }, "Errors": [ { "SuccessCode": "NOT_FOUND", "Meaning": "A submitted public key did not identify a record within this capability\u0027s declared scope.", "Recovery": "Re-check the key against a current list or creation response; do not treat this as a missing web route.", "Recoverable": true }, { "SuccessCode": "FAILED", "Meaning": "The capability could not complete for an execution failure.", "Recovery": "Read the returned message and error detail. Retry only when the response identifies a recoverable condition.", "Recoverable": false } ], "ActionResponse": { "RequiredResponseFields": [ "SuccessCode" ], "SuccessCodes": [ "SUCCESS" ], "FailureCodes": [ "NOT_FOUND", "FAILED" ], "NonFinalCodes": [], "MissingOrEmptyResponse": "Treat as FAILED.", "Rule": "The endpoint response is authoritative. Only an exact SuccessCode value listed in SuccessCodes means the business action succeeded; HTTP status alone does not declare the AIXE outcome." } }