{"openapi":"3.1.0","info":{"title":"faheemnaeem.dev API","version":"1.0.0","description":"Resume data as JSON. GET endpoints are public and CORS-enabled. Errors always look like {\"error\":{\"code\",\"message\"}}.","license":{"name":"MIT","url":"https://opensource.org/license/mit"}},"servers":[{"url":"https://api.faheemnaeem.dev","description":"Production"}],"tags":[{"name":"Resume"},{"name":"Projects"},{"name":"Fun"},{"name":"Interviews"}],"components":{"schemas":{"Profile":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"location":{"type":"string"},"timezone":{"type":"string"},"tagline":{"type":"string"},"summary":{"type":"string"},"about":{"type":"string"},"yearsOfExperience":{"type":"integer"},"focusAreas":{"type":"array","items":{"type":"string"}},"links":{"$ref":"#/components/schemas/Links"}},"required":["name","title","location","timezone","tagline","summary","about","yearsOfExperience","focusAreas","links"]},"Links":{"type":"object","properties":{"website":{"type":"string","format":"uri"},"linkedin":{"type":"string","format":"uri"},"github":{"type":["string","null"],"format":"uri"}},"required":["website","linkedin","github"]},"Skill":{"type":"object","properties":{"name":{"type":"string","example":"React.js"},"group":{"type":"string","example":"Frameworks"},"level":{"type":"string","enum":["expert","proficient","familiar"]},"years":{"type":"integer"},"sample":{"type":"boolean","description":"true when the level/years are placeholder values"}},"required":["name","group","level","years","sample"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND"},"message":{"type":"string","example":"Resource not found"},"details":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"]}}},"required":["code","message"]}},"required":["error"]},"Experience":{"type":"object","properties":{"index":{"type":"integer","description":"0 = most recent role"},"company":{"type":"string"},"role":{"type":"string"},"location":{"type":"string"},"start":{"type":"string","example":"2021"},"end":{"type":["string","null"],"description":"null = current role"},"highlights":{"type":"array","items":{"type":"string"}},"tech":{"type":"array","items":{"type":"string"}}},"required":["index","company","role","location","start","end","highlights","tech"]},"Project":{"type":"object","properties":{"id":{"type":"string","example":"faheemnaeem-dev"},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"tech":{"type":"array","items":{"type":"string"}},"repoUrl":{"type":["string","null"],"format":"uri"},"liveUrl":{"type":["string","null"],"format":"uri"},"status":{"type":"string","enum":["live","archived","wip"]},"sample":{"type":"boolean"}},"required":["id","name","tagline","description","tech","repoUrl","liveUrl","status","sample"]},"FunFact":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"}},"required":["id","text"]},"HireMe":{"type":"object","properties":{"message":{"type":"string"},"available":{"type":"boolean"},"nextSteps":{"type":"array","items":{"type":"string"}},"contact":{"type":"object","properties":{"email":{"type":"string","format":"email"},"linkedin":{"type":"string","format":"uri"},"github":{"type":["string","null"],"format":"uri"},"website":{"type":"string","format":"uri"},"interviewRequest":{"type":"string"},"contactForm":{"type":"string"}},"required":["email","linkedin","github","website","interviewRequest","contactForm"]}},"required":["message","available","nextSteps","contact"]},"InterviewRequestCreated":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["received"]},"message":{"type":"string"}},"required":["id","status","message"]},"InterviewRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"example":"Ada Lovelace"},"company":{"type":"string","minLength":1,"maxLength":100,"example":"Analytical Engines Ltd"},"email":{"type":"string","maxLength":254,"format":"email","example":"ada@example.com"},"role":{"type":"string","minLength":1,"maxLength":100,"example":"Senior Software Engineer"},"message":{"type":"string","minLength":10,"maxLength":2000,"example":"We would love to chat about a backend role."},"turnstileToken":{"type":"string","minLength":1,"maxLength":2048,"description":"Cloudflare Turnstile token from the widget on a faheemnaeem.dev page"}},"required":["name","company","email","role","message","turnstileToken"],"additionalProperties":false}},"parameters":{}},"paths":{"/v1/profile":{"get":{"tags":["Resume"],"summary":"Profile summary and public links","responses":{"200":{"description":"Profile","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Profile"}},"required":["data"]}}}}}}},"/v1/skills":{"get":{"tags":["Resume"],"summary":"Skills, optionally filtered by level and name","parameters":[{"schema":{"type":"string","enum":["expert","proficient","familiar"],"example":"expert"},"required":false,"name":"level","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":50,"description":"Case-insensitive substring match on the skill name","example":"react"},"required":false,"description":"Case-insensitive substring match on the skill name","name":"q","in":"query"}],"responses":{"200":{"description":"Matching skills","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Skill"}},"meta":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/experience":{"get":{"tags":["Resume"],"summary":"Work history, most recent first","responses":{"200":{"description":"All roles","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Experience"}},"meta":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]}},"required":["data","meta"]}}}}}}},"/v1/experience/{index}":{"get":{"tags":["Resume"],"summary":"One role by index (0 = most recent)","parameters":[{"schema":{"type":"integer","example":"0"},"required":true,"name":"index","in":"path"}],"responses":{"200":{"description":"The role","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Experience"}},"required":["data"]}}}},"400":{"description":"Index is not a non-negative integer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No role at that index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects":{"get":{"tags":["Projects"],"summary":"Projects, optionally filtered by status and technology","parameters":[{"schema":{"type":"string","enum":["live","archived","wip"],"example":"live"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":50,"description":"Case-insensitive exact match on a technology","example":"typescript"},"required":false,"description":"Case-insensitive exact match on a technology","name":"tech","in":"query"}],"responses":{"200":{"description":"Matching projects","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"meta":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}":{"get":{"tags":["Projects"],"summary":"One project by id","parameters":[{"schema":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","example":"faheemnaeem-dev"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The project","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Project"}},"required":["data"]}}}},"400":{"description":"Malformed id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/random-fact":{"get":{"tags":["Fun"],"summary":"A random fun fact (not cached)","responses":{"200":{"description":"A fun fact","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FunFact"}},"required":["data"]}}}}}}},"/v1/hire-me":{"get":{"tags":["Fun"],"summary":"How to hire me","responses":{"200":{"description":"Contact details and next steps","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/HireMe"}},"required":["data"]}}}}}}},"/teapot":{"get":{"tags":["Fun"],"summary":"418 I'm a teapot","responses":{"418":{"description":"I'm a teapot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/interview-requests":{"post":{"tags":["Interviews"],"summary":"Request an interview","description":"Browser-only: requires a Cloudflare Turnstile token and an Origin of https://faheemnaeem.dev or a subdomain. Limited to 5 requests per hour per IP. The no-JS form at /contact may also POST application/x-www-form-urlencoded (field cf-turnstile-response) and receives an HTML page.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewRequest"}}}},"responses":{"201":{"description":"Stored (a form-encoded POST gets an HTML thank-you page instead)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InterviewRequestCreated"}},"required":["data"]}}}},"400":{"description":"Invalid body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin not allowed or Turnstile check failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body larger than 16 KB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (5 per hour per IP)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Server not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{}}