api usage explanation