{"openapi":"3.1.0","info":{"title":"Yari Infotech Engineering & Agent API","version":"1.0.0","description":"Versioned REST v1 API, zero-auth sandbox, asynchronous audit jobs, MCP server, and x402/MPP commerce endpoints for Yari Infotech.","contact":{"name":"Yari Infotech Engineering","email":"hello@yariinfotech.com","url":"https://yariinfotech.com/developers"},"x-service-info":{"categories":["software-development","engineering-consulting","ai-agents"]}},"servers":[{"url":"https://yariinfotech.com","description":"Production Origin"},{"url":"https://yariinfotech.com/api/v1/sandbox","description":"Zero-Auth Sandbox & Test Environment"}],"components":{"parameters":{"ApiVersionHeader":{"name":"X-API-Version","in":"header","required":false,"description":"Requested API version (defaults to 1.0.0).","schema":{"type":"string","default":"1.0.0"}},"IdempotencyKeyHeader":{"name":"Idempotency-Key","in":"header","required":false,"description":"Unique client-generated UUID to safely retry write requests without creating duplicate resources.","schema":{"type":"string","format":"uuid"}},"LimitParam":{"name":"limit","in":"query","required":false,"description":"Maximum number of items to return per page (1-50).","schema":{"type":"integer","minimum":1,"maximum":50,"default":12}},"CursorParam":{"name":"cursor","in":"query","required":false,"description":"Opaque pagination cursor returned by the previous page.","schema":{"type":"string"}}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"string","description":"Machine-readable error identifier such as NOT_FOUND, VALIDATION_ERROR, or RATE_LIMITED."},"message":{"type":"string","description":"Human-readable explanation of the error."},"status":{"type":"integer","description":"HTTP status code."},"requestId":{"type":"string","description":"Unique request correlation ID."}}}}},"PaginationMeta":{"type":"object","required":["total","limit","hasMore"],"properties":{"total":{"type":"integer","description":"Total matching records."},"limit":{"type":"integer","description":"Page size limit applied."},"hasMore":{"type":"boolean","description":"Whether additional pages exist."},"nextCursor":{"type":["string","null"],"description":"Cursor token for fetching the next page."}}},"ServiceItem":{"type":"object","required":["slug","title","pillar","shortDescription","url"],"properties":{"slug":{"type":"string","description":"Canonical service slug."},"title":{"type":"string","description":"Service display title."},"pillar":{"type":"string","enum":["build","connect","grow"],"description":"Strategic engineering pillar."},"shortDescription":{"type":"string","description":"Concise summary of the service."},"url":{"type":"string","format":"uri","description":"Canonical service detail page URL."}}},"ProjectItem":{"type":"object","required":["slug","title","url"],"properties":{"slug":{"type":"string","description":"Canonical case study slug."},"title":{"type":"string","description":"Case study title."},"industry":{"type":"string","description":"Industry vertical slug."},"summary":{"type":"string","description":"Executive summary."},"url":{"type":"string","format":"uri","description":"Canonical case study URL."}}},"AuditJobResponse":{"type":"object","required":["jobId","status","statusUrl"],"properties":{"jobId":{"type":"string","description":"Unique async job ID."},"status":{"type":"string","enum":["queued","running","completed","failed"],"description":"Current asynchronous job lifecycle status."},"statusUrl":{"type":"string","format":"uri","description":"Polling endpoint for checking job completion."},"targetUrl":{"type":"string","format":"uri","description":"URL being audited."}}},"SandboxInfo":{"type":"object","required":["sandbox","status","authRequired","baseUrl"],"properties":{"sandbox":{"type":"boolean","description":"Indicates live sandbox environment availability."},"status":{"type":"string","description":"Current sandbox status."},"authRequired":{"type":"boolean","description":"Whether authentication is required for sandbox calls."},"baseUrl":{"type":"string","format":"uri","description":"Base URL for versioned REST v1 sandbox endpoints."}}}},"headers":{"Deprecation":{"description":"RFC 9745 deprecation notice for legacy endpoints.","schema":{"type":"string","example":"true"}},"Sunset":{"description":"RFC 8594 HTTP-date when a deprecated endpoint will be retired.","schema":{"type":"string","example":"Fri, 31 Dec 2027 23:59:59 GMT"}}}},"paths":{"/api/v1/sandbox":{"get":{"summary":"Verify zero-auth sandbox environment status","description":"Returns live sandbox environment metadata, playground URL (/sandbox), and testable endpoints without credentials.","operationId":"getSandboxStatusV1","parameters":[{"$ref":"#/components/parameters/ApiVersionHeader"}],"responses":{"200":{"description":"Sandbox environment metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SandboxInfo"}}}}}}},"/api/v1/sandbox/services":{"get":{"summary":"Test sandboxed engineering services catalog","description":"Zero-auth test endpoint returning services catalog with X-Sandbox headers.","operationId":"listSandboxServicesV1","responses":{"200":{"description":"Sandboxed service catalog.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/services":{"get":{"summary":"List Yari Infotech engineering services (paginated)","description":"Returns a paginated list of Yari Infotech's 12 services across Build, Connect, and Grow pillars.","operationId":"listServicesV1","parameters":[{"name":"pillar","in":"query","required":false,"description":"Optional strategic pillar filter.","schema":{"type":"string","enum":["build","connect","grow","all"]}},{"$ref":"#/components/parameters/LimitParam"},{"$ref":"#/components/parameters/CursorParam"},{"$ref":"#/components/parameters/ApiVersionHeader"}],"responses":{"200":{"description":"Paginated service catalog.","content":{"application/json":{"schema":{"type":"object","required":["services","pagination"],"properties":{"services":{"type":"array","items":{"$ref":"#/components/schemas/ServiceItem"}},"pagination":{"$ref":"#/components/schemas/PaginationMeta"}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/projects":{"get":{"summary":"List public engineering case studies (paginated)","description":"Returns verified public case studies with measured outcomes and cursor pagination.","operationId":"listProjectsV1","parameters":[{"name":"industry","in":"query","required":false,"description":"Optional industry keyword filter.","schema":{"type":"string"}},{"$ref":"#/components/parameters/LimitParam"},{"$ref":"#/components/parameters/CursorParam"}],"responses":{"200":{"description":"Paginated case studies list.","content":{"application/json":{"schema":{"type":"object","required":["projects","pagination"],"properties":{"projects":{"type":"array","items":{"$ref":"#/components/schemas/ProjectItem"}},"pagination":{"$ref":"#/components/schemas/PaginationMeta"}}}}}},"400":{"description":"Invalid query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/audits":{"post":{"summary":"Queue an asynchronous digital readiness audit job","description":"Creates a non-blocking readiness audit job and returns 202 Accepted with a polling statusUrl. Supports Idempotency-Key.","operationId":"createAuditJobV1","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Target website URL to audit."}}}}}},"responses":{"202":{"description":"Audit job accepted for asynchronous processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditJobResponse"}}}},"400":{"description":"Invalid request payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/jobs/{jobId}":{"get":{"summary":"Poll asynchronous audit job status","description":"Retrieves current status and results for an asynchronous job created via POST /api/v1/audits.","operationId":"getAuditJobV1","parameters":[{"name":"jobId","in":"path","required":true,"description":"Asynchronous job identifier.","schema":{"type":"string"}}],"responses":{"200":{"description":"Job status and payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditJobResponse"}}}},"404":{"description":"Job not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}