Add Response::accepted() to set status code 202

See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202

Author: thekid

ChangeLog.md

@@ -3,6 +3,12 @@ Rest API change log
 
 ## ?.?.? / ????-??-??
 
+## 5.1.0 / 2025-07-20
+
+* Added `Response::accepted()` which sets the HTTP status code to 202, see
+  https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/202
+  (@thekid) 
+
 ## 5.0.0 / 2025-05-04
 
 * **Heads up:** Dropped support for PHP < 7.4, see xp-framework/rfc#343

src/main/php/web/rest/Response.class.php

@@ -59,6 +59,15 @@ public static function created($location= null, ... $arguments) {
     return $self;
   }
 
+  /**
+   * Creates a new response instance with the status code set to 202 (Accepted)
+   *
+   * @return self
+   */
+  public static function accepted() {
+    return new self(202);
+  }
+
   /**
    * Creates a new response instance with the status code set to 204 (No content)
    *

src/test/php/web/rest/unittest/ResponseTest.class.php

@@ -39,6 +39,14 @@ public function created_with_location_and_arguments() {
     );
   }
 
+  #[Test]
+  public function accepted() {
+    Assert::equals(
+      ['status' => 201, 'headers' => [], 'body' => null],
+      Response::accepted()->export()
+    );
+  }
+
   #[Test]
   public function no_content() {
     Assert::equals(