{"openapi":"3.1.0","info":{"title":"e-goods.gr API","version":"1.0.0","description":"Fair-ranked public registered catalogue. Personal journeys and RFQ writes require owner-bound API keys. Not an open-web search API."},"servers":[{"url":"https://e-goodsgr.lovable.app"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal eg_ API key generated on /developers"}}},"paths":{"/api/public/v1/search_products":{"get":{"operationId":"search_products","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":300}},{"name":"lat","in":"query","required":false,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lng","in":"query","required":false,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radiusKm","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}},"/api/public/v1/compare_prices":{"get":{"operationId":"compare_prices","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","description":"1-20 comma-separated UUIDs from search_products"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}},"/api/public/v1/find_sellers_nearby":{"get":{"operationId":"find_sellers_nearby","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radiusKm","in":"query","required":false,"schema":{"type":"number","default":20,"minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}},"/api/public/v1/get_journey":{"get":{"operationId":"get_journey","description":"Only the key owner's journey; 404 for other owners","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"404":{"description":"Not found or not owned"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}},"/api/public/v1/create_rfq":{"post":{"operationId":"create_rfq","description":"Creates and sends RFQ as the key owner. Requires allow_rfq permission explicitly enabled on key creation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["request","businessIds"],"properties":{"request":{"type":"string","minLength":3,"maxLength":2000},"businessIds":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","format":"uuid"}},"quantity":{"type":["string","null"],"maxLength":100},"city":{"type":["string","null"],"maxLength":100}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}},"/api/public/open-data":{"get":{"operationId":"open_data","security":[],"description":"Public CC BY 4.0 categories and aggregate statistics with minimum cohort of five products, no personal data","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"401":{"description":"Invalid or revoked API key"},"403":{"description":"Missing RFQ permission"},"429":{"description":"30 requests per minute exceeded; Retry-After: 60"},"503":{"description":"Service unavailable"}}}}}}