update README with API explanation