{"openapi":"3.1.0","info":{"title":"Pfoten-Pur API","version":"1.0.0","description":"REST API for the Pfoten-Pur premium pet food e-commerce platform. Fully operable by AI agents.","contact":{"email":"info@pfoten-pur.de"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://pfoten-pur.de","description":"Production"},{"url":"http://localhost:3000","description":"Development"}],"paths":{"/api/v1/products":{"get":{"summary":"List products","description":"Returns a paginated list of products with optional filters","tags":["Products"],"parameters":[{"name":"species","in":"query","schema":{"type":"string","enum":["DOG","CAT","BOTH"]}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"line","in":"query","schema":{"type":"string","enum":["pur","sensitiv","vital","junior"]}},{"name":"tags","in":"query","schema":{"type":"string","description":"Comma-separated tags"}},{"name":"bestseller","in":"query","schema":{"type":"string","enum":["true","false"]}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":24,"maximum":100}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Product list with pagination metadata","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"},"links":{"$ref":"#/components/schemas/PaginationLinks"}}}}}}}}},"/api/v1/products/{slug}":{"get":{"summary":"Get product by slug","tags":["Products"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Product detail","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Product"}}}}}},"404":{"description":"Product not found"}}}},"/api/v1/categories":{"get":{"summary":"Get category tree","tags":["Categories"],"responses":{"200":{"description":"Category tree"}}}},"/api/v1/newsletter":{"post":{"summary":"Subscribe to newsletter","tags":["Newsletter"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email"},"first_name":{"type":"string"},"pet_types":{"type":"array","items":{"type":"string","enum":["DOG","CAT","BOTH"]}}}}}}},"responses":{"201":{"description":"Subscription created"},"400":{"description":"Invalid email"}}}},"/api/mcp":{"get":{"summary":"MCP server manifest","description":"Returns the Model Context Protocol manifest with all available tools","tags":["MCP"],"responses":{"200":{"description":"MCP manifest"}}},"post":{"summary":"Execute MCP tool","tags":["MCP"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tool"],"properties":{"tool":{"type":"string","enum":["search_products","get_product","get_feeding_guide","subscribe_newsletter","get_categories","search_ratgeber","get_ingredient_glossary","recommend_food"]},"parameters":{"type":"object"}}}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Tool result"},"400":{"description":"Unknown tool"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Product":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"sku":{"type":"string"},"name":{"type":"string"},"name_en":{"type":"string"},"brand":{"type":"string"},"species":{"type":"string","enum":["DOG","CAT","BOTH"]},"category":{"type":"string"},"line":{"type":"string"},"description":{"type":"string"},"description_en":{"type":"string"},"ingredients":{"type":"string"},"analytical_constituents":{"type":"object"},"feeding_guide":{"type":"object"},"images":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"is_active":{"type":"boolean"},"is_bestseller":{"type":"boolean"},"product_variants":{"type":"array","items":{"$ref":"#/components/schemas/ProductVariant"}}}},"ProductVariant":{"type":"object","properties":{"id":{"type":"string"},"size":{"type":"string"},"price":{"type":"number"},"compare_price":{"type":"number"},"stock_status":{"type":"string","enum":["IN_STOCK","LOW_STOCK","OUT_OF_STOCK","DROPSHIP"]},"ean":{"type":"string"}}},"PaginationMeta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"pages":{"type":"integer"}}},"PaginationLinks":{"type":"object","properties":{"self":{"type":"string"},"next":{"type":"string","nullable":true}}}}}}