pythonfile-uploadpostmanfastapi

How to send file to FastAPI endpoint using Postman?


I faced the difficulty of testing api using postman. Through swagger file upload functionality works correctly, I get a saved file on my hard disk. I would like to understand how to do this with Postman. I use the standard way to work with files which I use when working with Django and Flask:

Body -> form-data: key=file, value=image.jpeg

But with FastAPI, I get an error:

127.0.0.1:54294 - "POST /uploadfile/ HTTP/1.1" 422 Unprocessable Entity

main.py

@app.post("/uploadfile/")
async def create_upload_file(file: UploadFile = File(...)):
    img = await file.read()
    if file.content_type not in ['image/jpeg', 'image/png']:
        raise HTTPException(status_code=406, detail="Please upload only .jpeg files")
    async with aiofiles.open(f"{file.filename}", "wb") as f:
        await f.write(img)
    return {"filename": file.filename}

I also tried body -> binary: image.jpeg, but got the same result:

postman query


Solution

  • My code:

    from fastapi import FastAPI, UploadFile, File
    
    app = FastAPI()
    
    @app.post("/file/")
    async def create_upload_file(file: UploadFile = File(...)):
        return {"filename": file.filename}
    

    Setup in Postman: enter image description here

    As stated in https://github.com/tiangolo/fastapi/issues/1653, the parameter name for the file is the key value that you have to use. Before you were using key=file and value=image.png (or whatever). Instead, FastAPI accepts file=image.png. Thus the error, since the file is necessary, but it is not present (at least, the key with that name is not present).

    P.S. I tested it with Postman v7.16.1