{"openapi":"3.1.0","info":{"title":"Octa GST API","version":"1.0.0","description":"API for Octa GST — a comprehensive GST compliance platform for Indian businesses, built by Blowbits Solutions LLP.","contact":{"name":"Octa GST Support","url":"https://octagst.com/contact"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://octagst.com","description":"Production"}],"paths":{"/api/deal":{"post":{"operationId":"createDeal","summary":"Submit a new sales inquiry / deal request","description":"Creates a new sales inquiry with contact details. Requires a valid Cloudflare Turnstile captcha token for bot protection. The request is forwarded to the internal CRM system.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealInput"}}}},"responses":{"200":{"description":"Deal submitted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealSuccessResponse"}}}},"400":{"description":"Validation error — missing or invalid fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error — backend or captcha validation failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"DealInput":{"type":"object","required":["contactName","businessName","email","mobile","turnstileToken"],"properties":{"contactName":{"type":"string","minLength":1,"maxLength":100,"description":"Full name of the contact person"},"businessName":{"type":"string","minLength":1,"maxLength":100,"description":"Name of the business or organization"},"email":{"type":"string","format":"email","minLength":1,"maxLength":100,"description":"Email address of the contact person"},"mobile":{"type":"string","pattern":"^[0-9]{10}$","description":"10-digit Indian mobile number (without country code)"},"requirements":{"type":"string","maxLength":1000,"description":"Optional description of business requirements"},"turnstileToken":{"type":"string","minLength":1,"maxLength":2000,"description":"Cloudflare Turnstile captcha verification token"}}},"DealSuccessResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true],"description":"Indicates the deal was submitted successfully"},"message":{"type":"string","description":"Success message"}},"required":["success","message"]},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"description":"Always false for error responses"},"error":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","description":"Machine-readable error code","enum":["VALIDATION_ERROR","CAPTCHA_FAILED","MISSING_CONFIG","BACKEND_ERROR","UNKNOWN_ERROR"]},"resolution":{"type":"string","description":"Suggested action to resolve the error"}},"required":["success","error","code"]}}}}