https://medium.com/@matryer/introducing-silk-markdown-driven-api-tests-1f8cfb0ef99a Отличный пример как обить двух зайцев одним выстрелом. Разработчик Mat Ryer предлагает писать документацию к API в формате markdown (казалось бы ничего необычного), а также использовать её как готовый тестовый сценарий