Add comprehensive API documentation with all endpoints and examples

initial commit