Add create_amphibian endpoint for validation.

Author: reedrodgers-openSea

main.py

@@ -1,15 +1,45 @@
 from typing import Union
 
-from fastapi import FastAPI
+from fastapi import FastAPI, HTTPException
+from pydantic import BaseModel
 
 app = FastAPI()
 
 
 @app.get("/")
 def read_root():
     return {"Hello": "World"}
+class Creature(BaseModel):
+    id: int
+    family: str
+    common_name: str
+    class Config:
+        schema_extra = {
+            "example": {
+                "id": 1,
+                "family": "Amphibian",
+                "name": "Frog"
+            }
+        }
 
+class AuthenticationError(HTTPException):
+    def __init__(self, detail: str):
+        super().__init__(status_code=401, detail=detail)
 
-@app.get("/items/{item_id}")
+    
+creatures: list[Creature] = [Creature(id=1, family="Amphibian", common_name="Frog")]
+
+@app.get("/creatures/{creature_id}")
 def read_item(item_id: int, q: Union[str, None] = None):
-    return {"item_id": item_id, "q": q}
+    return {"item_id": item_id, "q": q}
+
+@app.post("/create_amphibian")
+def create_amphibian(creature: Creature, user_level: int, throws: bool = False) -> bool:
+    if throws:
+        raise Exception("This is an unexpected exception")
+    if creature.family != "Amphibian": # validation error not caught by FastAPI
+        raise HTTPException(status_code=400, detail="Only amphibians allowed")
+    if user_level < 2:
+        raise AuthenticationError(status_code=403, detail="You are not admin")
+    creatures.append(creature)
+    return True