soc/flask-openap.../README.md

Flask OpenAPI Demo for Shuffle

This project is an OpenAPI-first Flask service using Connexion.

Endpoints

• GET /health
• POST /echo
• GET /ioc/{value}
• Swagger UI: GET /ui
• OpenAPI spec: GET /openapi.json

Run with Docker

cd /Users/simplicoltd./projects/soc/flask-openapi-shuffle
docker compose up --build

Test quickly:

curl -s http://localhost:8000/health
curl -s -X POST http://localhost:8000/echo -H 'Content-Type: application/json' -d '{"message":"hello"}'
curl -s http://localhost:8000/ioc/8.8.8.8

Use with Shuffle

In Shuffle App Creator / OpenAPI import, use one of these URLs:

• http://localhost:8000/openapi.json (if Shuffle can reach your host localhost)
• http://host.docker.internal:8000/openapi.json (common when Shuffle runs in Docker on Mac/Windows)
• http://<your-host-ip>:8000/openapi.json (Linux Docker or remote host)