Plan pydantic for modeling the data

I'm collecting some ideas now. I think this would make using the API a lot easier.

The plan would be to start with one or two entities and implement them as pydantic model, but if that's an approach we want to take it should probably be extended with autogenerated code.

With `extra="allow"` there is some flexibility in building backward compatibility on top of the existing code.