chore(extensions): unified contribution api and automatic prefixing (#38412)

docs/developer_docs/extensions/quick-start.md

@@ -129,11 +129,15 @@ The CLI generated a basic `backend/src/superset_extensions/my_org/hello_world/en
 ```python
 from flask import Response
 from flask_appbuilder.api import expose, protect, safe
-from superset_core.api.rest_api import RestApi
+from superset_core.api.rest_api import RestApi, api
 
 
+@api(
+    id="hello_world_api",
+    name="Hello World API",
+    description="API endpoints for the Hello World extension"
+)
 class HelloWorldAPI(RestApi):
-    resource_name = "hello_world"
     openapi_spec_tag = "Hello World"
     class_permission_name = "hello_world"
 
@@ -170,25 +174,25 @@ class HelloWorldAPI(RestApi):
 
 **Key points:**
 
-- Extends `RestApi` from `superset_core.api.types.rest_api`
+- Uses [`@api`](superset-core/src/superset_core/api/rest_api.py:59) decorator with automatic context detection
+- Extends `RestApi` from `superset_core.api.rest_api`
 - Uses Flask-AppBuilder decorators (`@expose`, `@protect`, `@safe`)
 - Returns responses using `self.response(status_code, result=data)`
-- The endpoint will be accessible at `/extensions/my-org/hello-world/message`
+- The endpoint will be accessible at `/extensions/my-org/hello-world/message` (automatic extension context)
 - OpenAPI docstrings are crucial - Flask-AppBuilder uses them to automatically generate interactive API documentation at `/swagger/v1`, allowing developers to explore endpoints, understand schemas, and test the API directly from the browser
 
 **Update `backend/src/superset_extensions/my_org/hello_world/entrypoint.py`**
 
-Replace the generated print statement with API registration:
+Replace the generated print statement with API import to trigger registration:
 
 ```python
-from superset_core.api import rest_api
-
+# Importing the API class triggers the @api decorator registration
 from .api import HelloWorldAPI
 
-rest_api.add_extension_api(HelloWorldAPI)
+print("Hello World extension loaded successfully!")
 ```
 
-This registers your API with Superset when the extension loads.
+The [`@api`](superset-core/src/superset_core/api/rest_api.py:59) decorator automatically detects extension context and registers your API with proper namespacing.
 
 ## Step 5: Create Frontend Component
 
@@ -328,16 +332,16 @@ const HelloWorldPanel: React.FC = () => {
   const [error, setError] = useState<string>('');
 
   useEffect(() => {
-    const fetchMessage = async () => {
-      try {
-        const csrfToken = await authentication.getCSRFToken();
-        const response = await fetch('/extensions/my-org/hello-world/message', {
-          method: 'GET',
-          headers: {
-            'Content-Type': 'application/json',
-            'X-CSRFToken': csrfToken!,
-          },
-        });
+      const fetchMessage = async () => {
+          try {
+              const csrfToken = await authentication.getCSRFToken();
+              const response = await fetch('/extensions/my-org/hello-world/message', {
+                  method: 'GET',
+                  headers: {
+                      'Content-Type': 'application/json',
+                      'X-CSRFToken': csrfToken!,
+                  },
+              });
 
         if (!response.ok) {
           throw new Error(`Server returned ${response.status}`);
@@ -493,7 +497,7 @@ Superset will extract and validate the extension metadata, load the assets, regi
 Here's what happens when your extension loads:
 
 1. **Superset starts**: Reads `extension.json` and loads the backend entrypoint
-2. **Backend registration**: `entrypoint.py` registers your API via `rest_api.add_extension_api()`
+2. **Backend registration**: `entrypoint.py` imports your API class, triggering the [`@api`](superset-core/src/superset_core/api/rest_api.py:59) decorator to register it automatically
 3. **Frontend loads**: When SQL Lab opens, Superset fetches the remote entry file
 4. **Module Federation**: Webpack loads your extension module and resolves `@apache-superset/core` to `window.superset`
 5. **Registration**: The module executes at load time, calling `views.registerView` to register your panel