feat(apigateway): add binaryMediaTypes property to SpecRestApi (#35502)

### Issue #35498

### Reason for this change

The `SpecRestApi` construct was missing the `binaryMediaTypes` property that is available in the regular `RestApi` construct. 

### Description of changes

- Added `binaryMediaTypes` property to `SpecRestApiProps` interface**: This property accepts an array of strings representing binary media types (e.g., `['image/png', 'application/pdf']`)
- Updated `SpecRestApi` constructor**: Modified to pass the `binaryMediaTypes` property to the underlying `CfnRestApi` resource
- Updated README documentation: Added usage example showing how to use `binaryMediaTypes` with `SpecRestApi`

### Describe any new or updated permissions being added

N/A


### Description of how you validated changes

- Added unit tests: Created tests to verify that the `binaryMediaTypes` property is correctly passed to CloudFormation
- Added integration tests: Updated existing integration test to include `binaryMediaTypes` configuration

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: matoom-nomu

packages/@aws-cdk-testing/framework-integ/test/aws-apigateway/test/integ.spec-restapi.js.snapshot/apigatewayspecrestapiDefaultTestDeployAssertD16AA485.assets.json

@@ -3,6 +3,10 @@
   "myapi4C7BF186": {
    "Type": "AWS::ApiGateway::RestApi",
    "Properties": {
+    "BinaryMediaTypes": [
+     "image/png",
+     "application/pdf"
+    ],
     "BodyS3Location": {
      "Bucket": {
       "Fn::Sub": "cdk-hnb659fds-assets-${AWS::AccountId}-${AWS::Region}"
@@ -518,7 +522,7 @@
    "UpdateReplacePolicy": "Retain",
    "DeletionPolicy": "Retain"
   },
-  "myapiDeployment92F2CB491b0e40e722acabc99cc39958c957686d": {
+  "myapiDeployment92F2CB49a6f2b34c48304b5ea39e505074a5a8ee": {
    "Type": "AWS::ApiGateway::Deployment",
    "Properties": {
     "Description": "beta stage",
@@ -550,7 +554,7 @@
     "CacheClusterEnabled": true,
     "CacheClusterSize": "0.5",
     "DeploymentId": {
-     "Ref": "myapiDeployment92F2CB491b0e40e722acabc99cc39958c957686d"
+     "Ref": "myapiDeployment92F2CB49a6f2b34c48304b5ea39e505074a5a8ee"
     },
     "Description": "beta stage",
     "MethodSettings": [

packages/@aws-cdk-testing/framework-integ/test/aws-apigateway/test/integ.spec-restapi.js.snapshot/cdk.out

@@ -14,6 +14,7 @@ class Test extends cdk.Stack {
       apiDefinition: apigateway.ApiDefinition.fromAsset(path.join(__dirname, 'sample-definition.yaml')),
       disableExecuteApiEndpoint: true,
       minCompressionSize: Size.bytes(1024),
+      binaryMediaTypes: ['image/png', 'application/pdf'],
       retainDeployments: true,
       cloudWatchRole: true,
       deployOptions: {

packages/@aws-cdk-testing/framework-integ/test/aws-apigateway/test/integ.spec-restapi.js.snapshot/integ.json

@@ -1652,6 +1652,15 @@ const api = new apigateway.SpecRestApi(this, 'books-api', {
 });
 ```
 
+`SpecRestApi` also supports binary media types, similar to `RestApi`:
+
+```ts
+const api = new apigateway.SpecRestApi(this, 'books-api', {
+  apiDefinition: apigateway.ApiDefinition.fromAsset('path-to-file.json'),
+  binaryMediaTypes: ['image/png', 'application/pdf']
+});
+```
+
 ### Endpoint configuration
 
 By default, `SpecRestApi` will create an edge optimized endpoint.

packages/@aws-cdk-testing/framework-integ/test/aws-apigateway/test/integ.spec-restapi.js.snapshot/manifest.json

@@ -300,6 +300,14 @@ export interface SpecRestApiProps extends RestApiBaseProps {
    */
   readonly apiDefinition: ApiDefinition;
 
+  /**
+   * The list of binary media mime-types that are supported by the SpecRestApi
+   * resource, such as "image/png" or "application/octet-stream"
+   *
+   * @default - SpecRestApi supports only UTF-8-encoded text payloads.
+   */
+  readonly binaryMediaTypes?: string[];
+
   /**
    * A Size(in bytes, kibibytes, mebibytes etc) that is used to enable compression (with non-negative
    * between 0 and 10485760 (10M) bytes, inclusive) or disable compression
@@ -802,6 +810,7 @@ export class SpecRestApi extends RestApiBase {
       policy: Lazy.any({ produce: () => this.resourcePolicy }),
       failOnWarnings: props.failOnWarnings,
       minimumCompressionSize: props.minCompressionSize?.toBytes(),
+      binaryMediaTypes: props.binaryMediaTypes,
       body: apiDefConfig.inlineDefinition ?? undefined,
       bodyS3Location: apiDefConfig.inlineDefinition ? undefined : apiDefConfig.s3Location,
       endpointConfiguration: this._configureEndpoints(props),