update interface spec

1, explain return value format
2, fix bug.