add new/clearer configuration for swagger spec path; distinguish the meaning of api_base_path as the actual api basePath; update README for config