Api clarifications