Хотите с API работать через докрину?
Взгляните на
https://github.com/doctrine/skeleton-mapper и на пример реализации
https://github.com/Coffreo/ceph-odm
Да, придётся реализовать некоторые вещи, но вы не будете зависить от прибытых гвоздями форматов предлагаемые DoctrineRestDriver
А только имеет ли это смысл?
Если вам необходимо реализовать "смешанные" сущности, например у вас есть Product, а данные этого Product лежат в API - идеальным решением реализовать подгрузку данных на postLoad доктриновского события.
Нужны объекты, а не raw данные из API? Посмотрите в сторону того же JMS или симфониевского сериалайзера, которого с головой хватает в большинстве случаев.
Но всё это оправдано в том случае, если вам действительно нужно воткнуть работу с API под доктриновскую абстракцию...
> Что если вообще сделать маленькую прослойку с использованием условного gazzle и в репозиториях сделать вызовы?
Встречавшиеся мне реализации в реальных проектах - в 99% случаев именно так и поступают. (В некоторых - к сожалению, а в некоторых к счастью, потому что крайне просто поддерживать)