salah-xd / chess-fastapi

Chess API

This is a FastAPI application that provides an API endpoint to determine the valid moves for a given chess piece on a chessboard.

Setup

1. pull the image from docker hub:

   docker pull salahxd/chess-api   

2. Run the Docker container:

   docker run -d --name chess-api -p 8000:8000 salahxd/chess-api

Usage

Use tools like Postman or curl to test the API endpoints. For example:

curl -X POST "http://localhost:8000/chess/knight" -H "Content-Type: application/json" -d '{
    "positions": {
        "Queen": "E7",
        "Bishop": "B7",
        "Rook": "G5",
        "Knight": "C3"
    }
}'

curl -X POST "http://localhost:8000/chess/queen" -H "Content-Type: application/json" -d '{
    "positions": {
        "Queen": "H1",
        "Bishop": "B7",
        "Rook": "H8",
        "Knight": "F3"
    }
}'

curl -X POST "http://localhost:8000/chess/rook" -H "Content-Type: application/json" -d '{
    "positions": {
        "Queen": "A5",cker
        "Bishop": "G8",
        "Rook": "H5",
        "Knight": "G4"
    }
}'