add request headers to apiary docs

closes #324 

@edpaget do i have to manually copy these changes over to apiary?