more notes on api