{"openapi":"3.1.0","info":{"title":"EngineerPro — library & tools API","version":"1.0.0","description":"Public read-only REST twins for the EngineerPro engineering library (118 books) and software-engineering tools catalog. The same data is available over MCP at https://api.aiengineerprofessional.com/api/mcp.","contact":{"name":"EngineerPro","url":"https://aiengineerprofessional.com"}},"servers":[{"url":"https://api.aiengineerprofessional.com"}],"tags":[{"name":"engineerpro-library","description":"Engineering library and tools catalog."}],"paths":{"/api/v1/library":{"get":{"operationId":"library-list","summary":"List engineering library books","description":"Returns compact rows from the EngineerPro 118-book library slice: title, author, lane tags, and whether a structured profile exists.","tags":["engineerpro-library"],"parameters":[{"name":"lane","in":"query","required":false,"description":"Optional eng_guides lane filter, e.g. software-engineering.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max rows (default 100, max 500).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Library list with total_matching, count, and book summaries.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/library/{libraryId}":{"get":{"operationId":"library-get","summary":"Get one library book profile","description":"Returns one canonical library row plus its structured book profile (thesis, model, instrument summary) when a sidecar exists.","tags":["engineerpro-library"],"parameters":[{"name":"libraryId","in":"path","required":true,"description":"Stable library id, e.g. lib0391f4cb77510b42.","schema":{"type":"string"}}],"responses":{"200":{"description":"Book summary with optional profile block.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown library id or empty search."}}}},"/api/v1/library/search":{"get":{"operationId":"library-search","summary":"Search the engineering library","description":"Substring search across title, author, lane tags, and classifier tags.","tags":["engineerpro-library"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search query.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max rows (default 50, max 200).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Matching book summaries.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing q parameter."},"404":{"description":"Unknown library id or empty search."}}}},"/api/v1/tools":{"get":{"operationId":"tools-list","summary":"List software-engineering interactive tools","description":"Catalog of SE tools surfaced on softwareengineeringprofessional.com with REST path hints.","tags":["engineerpro-library"],"responses":{"200":{"description":"Tool catalog rows.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/concepts":{"get":{"operationId":"concepts-list","summary":"List engineering concepts","description":"Definition-first engineering concepts derived from the canonical guide bodies (EP-217), each with a cited answer and grounding books.","tags":["engineerpro-library"],"parameters":[{"name":"lane","in":"query","required":false,"description":"Optional lane filter: ai, data, or software.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max rows (default 100, max 200).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Concept list with total_matching, count, and concept rows.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/concepts/{slug}":{"get":{"operationId":"concepts-get","summary":"Get one engineering concept","description":"Return one concept's definition, cited answer, and grounding books by slug.","tags":["engineerpro-library"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Concept slug, e.g. prompt-engineering-quality.","schema":{"type":"string"}}],"responses":{"200":{"description":"One concept row.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown library id or empty search."}}}},"/api/v1/tradeoffs":{"get":{"operationId":"tradeoffs-list","summary":"List engineering trade-offs","description":"Named engineering tensions derived from the canonical guide bodies (EP-217), each with opposing camps and cited grounding books.","tags":["engineerpro-library"],"parameters":[{"name":"lane","in":"query","required":false,"description":"Optional lane filter: ai, data, or software.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max rows (default 100, max 200).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Trade-off list with total_matching, count, and trade-off rows.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tradeoffs/{slug}":{"get":{"operationId":"tradeoffs-get","summary":"Get one engineering trade-off","description":"Return one trade-off's tension, camps, cited answer, and grounding books by slug.","tags":["engineerpro-library"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Trade-off slug, e.g. microservices-vs-monolith.","schema":{"type":"string"}}],"responses":{"200":{"description":"One trade-off row.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown library id or empty search."}}}},"/api/v1/tools/search":{"get":{"operationId":"tools-search","summary":"Find a software-engineering tool","description":"Substring search across the SE tools catalog and its guide bindings (EP-219: bound step, construct, tension).","tags":["engineerpro-library"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search query.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max rows (default 20, max 50).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Matching tool rows with matched_on fields.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown library id or empty search."}}}},"/api/v1/guides":{"get":{"operationId":"guides-list","summary":"List the flagship engineering guides with free overview excerpts","description":"Returns the three hosted flagship guides (AI, data, software engineering) with their take-away URLs and source book counts. Free cited excerpt available via the get endpoint.","tags":["engineerpro-library"],"responses":{"200":{"description":"Guide list with slugs, lanes, and take_away_urls.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/guides/{slug}":{"get":{"operationId":"guides-get","summary":"Get a guide's free overview and cited sources","description":"Returns the free overview excerpt for a flagship engineering guide plus the apex take-away link and cited source books. Optional section parameter returns a specific section summary and its grounding citations.","tags":["engineerpro-library"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Guide slug, e.g. software-engineering, ai-engineering, data-engineering.","schema":{"type":"string"}},{"name":"section","in":"query","required":false,"description":"Optional section name substring to return a specific section summary and grounding citations.","schema":{"type":"string"}}],"responses":{"200":{"description":"Guide overview, take_away_url, sources, and optional section block.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown library id or empty search."}}}}}}