Pretty happy today with my #BDD setup, where I can document the contract for a third party API in the same feature file that describes the effect of using it.

The calls to the 3rd party are mocked, everything else run on a real instance.