[#247] add some api specs