update interface spec

1, explain return value format
2, fix bug.
Merge pull request #2 from milliyang/master

update interface spec