Why does the first one generate doc and the second one not

[xiaxichen]

This demo generates a doc document

insert_router = APIRouter()
@insert_router.post("/items/")
async def create_item(item: Item):
item_dict = item.dict()
if item.tax:
price_with_tax = item.price + item.tax
item_dict.update({"price_with_tax": price_with_tax})
return item_dict

This demo doesn't generate docs

@insert_router.route(path="/items/",methods=["post"])
async def create_item(item: Item):
item_dict = item.dict()
if item.tax:
price_with_tax = item.price + item.tax
item_dict.update({"price_with_tax": price_with_tax})
return item_dict

Is this a bug?

[ycd]

Hey @xiaxichen can you reformat your code?

[SirTelemak]

insert_router.route is Starlette's method that knows nothing about API. In your case you should use FastAPI method that also adds API doc insert_router.api_route

[xiaxichen]

insert_router.route is Starlette's method that knows nothing about API. In your case you should use FastAPI method that also adds API doc insert_router.api_route

However, this routing registration can not be used to generate documents.
@insert_router.route(path="/items/",methods=["post"])

[xiaxichen]

Hey @xiaxichen can you reformat your code?

insert_router = APIRouter()
@insert_router.post("/items/")
async def create_item(item: Item):
	item_dict = item.dict()
	if item.tax:
		price_with_tax = item.price + item.tax
		item_dict.update({"price_with_tax": price_with_tax})
	return item_dict

This demo doesn't generate docs

@insert_router.route(path="/items/",methods=["post"])
async def create_item(item: Item):
	item_dict = item.dict()
	if item.tax:
		price_with_tax = item.price + item.tax
		item_dict.update({"price_with_tax": price_with_tax})
	return item_dict

there thanks

[SirTelemak]

insert_router.route is Starlette's method that knows nothing about API. In your case you should use FastAPI method that also adds API doc insert_router.api_route

However, this routing registration can not be used to generate documents.
@insert_router.route(path="/items/",methods=["post"])

Yes, it wouldn't generate docs since it's starlettes method. Use
@insert_router.api_route(path="/items/",methods=["post"]) instead

[tiangolo]

Thanks for the help here everyone! 👏 🙇

Thanks for reporting back and closing the issue 👍