List Extensions of own contributor

GET/contributors/{contributorId}/extensions/

API version

Request method

GET

Operation ID

extension-list-own-extensions

Request

contributorIdstring
required

Responses

Response headers

X-Pagination-Limitinteger
The limit used to select the resources for the response
X-Pagination-Skipinteger
The number of skipped items
X-Pagination-Pagenumber
The calculate page of the list response. Refer to parameters to learn more.
X-Pagination-TotalCountinteger
The total amount of items available in the remote ressource. Use this value in combination with the limit to calculate the available pages.

Format

application/json

Description

A list of extensions of the contributor.

Schema documentation
Example
JSON Schema

Array[
- *object
  - assetsarray of object
    required
    - Array[
      The following assets are the media that are associated with the extension and will be shown in extension details page.
      - *object
        The following assets are the media that are associated with the extension and will be shown in extension details page.
        assetTypestring (one of: image, video)
        required
        fileNamestring
        deprecated
        idstring (uuid)
        required
        The asset ID and reference ID to its file. Retrieve the file with this id on `/v2/files/{id}
        indexinteger
        required
        The index of the asset. Does not have to be successive. Can be used to order the assets.
      ]
  - backendComponentsobject
    deprecated
    - extensionAddedToContextobject
      deprecated
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceRemovedFromContextobject
      deprecated
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceSecretRotatedobject
      deprecated
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceUpdatedobject
      deprecated
      - urlstring (≥ 1 characters)
        required
  - blockedboolean
    deprecated
  - contextstring (one of: project, customer)
  - contributorIdstring
    required
  - deprecationobject
    The Extension is deprecated by the contributor and will expire at the given date.
    - deprecatedAtstring (date-time)
      required
    - notestring
    - successorIdstring (uuid)
      The ID of the successor extension.
  - descriptionstring
  - detailedDescriptionsobject
    A detailed description of the capabilities of the extension.
    - deobject
      required
      Language specific descriptions in various formats.
      - markdownstring (≥ 1 characters)
        required
      - plainstring (≥ 1 characters)
    - enobject
      Language specific descriptions in various formats.
      - markdownstring (≥ 1 characters)
        required
      - plainstring (≥ 1 characters)
  - disabledboolean
    deprecated
  - externalFrontendsarray of object
    - Array[
      - *object
        namestring
        required
        urlstring
        required
      ]
  - frontendComponentsarray of object
    deprecated
    - Array[
      - *object
        namestring
        required
        urlstring
        required
      ]
  - frontendFragmentsobject
    - *
  - functionalboolean
    required
  - idstring (uuid)
    required
  - logoRefIdstring (uuid)
    This is the FileId of the Logo. Retrieve the file with this id on /v2/files/{logoRefId}.
  - namestring
    required
  - pricingone of 1 alternatives
    - Alternativearray of object
      A price plan with (multiple) variants, including different prices for different included service descriptions
      - Array[
        *object
        deletionDeadlinestring (date-time)
        descriptionstring
        isBookingStoppedboolean
        required
        If a variant is no longer bookable the existing extension instances will not be removed but no new ones can be created.
        isDeletionScheduledboolean
        required
        keystring
        required
        namestring
        priceInCentsinteger
        required
        The monthly price in Euro Cents before tax.
        ]
  - pricingDetailsobject
    The details section of the price plan. It informs if choosing different variants as a upgrade or downgrade is possible.
    - isDowngradeAllowedboolean
      required
    - isUpgradeAllowedboolean
      required
  - publishedboolean
    required
  - requestedChangesobject
    - contextstring (one of: project, customer)
    - scopesarray of string
      - Array[
        *string
        ]
    - webhookUrlsone of 2 alternatives
      - Alternativeobject
        extensionAddedToContextobject
        required
        urlstring (≥ 1 characters)
        required
        extensionInstanceRemovedFromContextobject
        required
        urlstring (≥ 1 characters)
        required
        extensionInstanceSecretRotatedobject
        required
        urlstring (≥ 1 characters)
        required
        extensionInstanceUpdatedobject
        required
        urlstring (≥ 1 characters)
        required
      - Alternativeobject
  - scopesarray of string
    - Array[
      - *string
      ]
  - secretsarray of object
    required
    - Array[
      - *object
        secretIdstring (uuid)
        required
        usableUntilstring (date-time)
      ]
  - statestring (one of: enabled, blocked, disabled)
    deprecated
    deprecated
  - statisticsobject
    required
    - amountOfInstancesinteger (≥ 0)
      The amout of instances for this extension. Accurate for the Contributor. Publicly rounded to the next lower hundred.
  - subTitleobject
    A few words to promote your Extension.
    - destring (≤ 40 characters)
      required
    - enstring (≤ 40 characters)
  - support
  - tagsarray of string
    - Array[
      - *string
      ]
  - verificationRequestedboolean
    required
  - verifiedboolean
    required
  - webhookUrlsobject
    - extensionAddedToContextobject
      required
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceRemovedFromContextobject
      required
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceSecretRotatedobject
      required
      - urlstring (≥ 1 characters)
        required
    - extensionInstanceUpdatedobject
      required
      - urlstring (≥ 1 characters)
        required
]

Content-Type: application/json

[
  {
    "assets": [
      {
        "assetType": "image",
        "id": "f0f86186-0a5a-45b2-aa33-502777496347",
        "index": 1
      }
    ],
    "context": "project",
    "contributorId": "string",
    "deprecation": {
      "deprecatedAt": "1985-10-26T01:21:00.000Z",
      "note": "This extension is no longer actively maintained. Please Use the successor extension instead.",
      "successorId": "f0f86186-0a5a-45b2-aa33-502777496347"
    },
    "description": "string",
    "detailedDescriptions": {
      "de": {
        "markdown": "string",
        "plain": "string"
      },
      "en": {
        "markdown": "string",
        "plain": "string"
      }
    },
    "externalFrontends": [
      {
        "name": "string",
        "url": "string"
      }
    ],
    "frontendFragments": {
      "string": null
    },
    "functional": true,
    "id": "f0f86186-0a5a-45b2-aa33-502777496347",
    "logoRefId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "name": "string",
    "pricing": [
      {
        "deletionDeadline": "1985-10-26T01:21:00.000Z",
        "description": "string",
        "isBookingStopped": true,
        "isDeletionScheduled": true,
        "key": "string",
        "name": "string",
        "priceInCents": 123
      }
    ],
    "pricingDetails": {
      "isDowngradeAllowed": true,
      "isUpgradeAllowed": true
    },
    "published": true,
    "requestedChanges": {
      "context": "project",
      "scopes": [
        "string"
      ],
      "webhookUrls": {
        "extensionAddedToContext": {
          "url": "string"
        },
        "extensionInstanceRemovedFromContext": {
          "url": "string"
        },
        "extensionInstanceSecretRotated": {
          "url": "string"
        },
        "extensionInstanceUpdated": {
          "url": "string"
        }
      }
    },
    "scopes": [
      "string"
    ],
    "secrets": [
      {
        "secretId": "f0f86186-0a5a-45b2-aa33-502777496347",
        "usableUntil": "1985-10-26T01:21:00.000Z"
      }
    ],
    "statistics": {
      "amountOfInstances": 42
    },
    "subTitle": {
      "de": "Ping deine App an",
      "en": "Ping your app"
    },
    "support": null,
    "tags": [
      "string"
    ],
    "verificationRequested": true,
    "verified": true,
    "webhookUrls": {
      "extensionAddedToContext": {
        "url": "string"
      },
      "extensionInstanceRemovedFromContext": {
        "url": "string"
      },
      "extensionInstanceSecretRotated": {
        "url": "string"
      },
      "extensionInstanceUpdated": {
        "url": "string"
      }
    }
  }
]

{
  "items": {
    "properties": {
      "assets": {
        "items": {
          "description": "The following assets are the media that are associated with the extension and will be shown in extension details page.",
          "properties": {
            "assetType": {
              "enum": [
                "image",
                "video"
              ],
              "example": "image",
              "type": "string"
            },
            "fileName": {
              "deprecated": true,
              "example": "myFile.png",
              "type": "string"
            },
            "id": {
              "description": "The asset ID and reference ID to its file. Retrieve the file with this id on `/v2/files/{id}",
              "format": "uuid",
              "type": "string"
            },
            "index": {
              "description": "The index of the asset. Does not have to be successive. Can be used to order the assets.",
              "example": 1,
              "type": "integer"
            }
          },
          "required": [
            "id",
            "index",
            "assetType"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "backendComponents": {
        "deprecated": true,
        "properties": {
          "extensionAddedToContext": {
            "deprecated": true,
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceRemovedFromContext": {
            "deprecated": true,
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceSecretRotated": {
            "deprecated": true,
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceUpdated": {
            "deprecated": true,
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          }
        },
        "type": "object"
      },
      "blocked": {
        "deprecated": true,
        "type": "boolean"
      },
      "context": {
        "enum": [
          "project",
          "customer"
        ],
        "type": "string"
      },
      "contributorId": {
        "type": "string"
      },
      "deprecation": {
        "description": "The Extension is deprecated by the contributor and will expire at the given date.",
        "properties": {
          "deprecatedAt": {
            "format": "date-time",
            "type": "string"
          },
          "note": {
            "example": "This extension is no longer actively maintained. Please Use the successor extension instead.",
            "type": "string"
          },
          "successorId": {
            "description": "The ID of the successor extension.",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "deprecatedAt"
        ],
        "type": "object"
      },
      "description": {
        "type": "string"
      },
      "detailedDescriptions": {
        "description": "A detailed description of the capabilities of the extension.",
        "properties": {
          "de": {
            "description": "Language specific descriptions in various formats.",
            "properties": {
              "markdown": {
                "minLength": 1,
                "type": "string"
              },
              "plain": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "markdown"
            ],
            "type": "object"
          },
          "en": {
            "description": "Language specific descriptions in various formats.",
            "properties": {
              "markdown": {
                "minLength": 1,
                "type": "string"
              },
              "plain": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "markdown"
            ],
            "type": "object"
          }
        },
        "required": [
          "de"
        ],
        "type": "object"
      },
      "disabled": {
        "deprecated": true,
        "type": "boolean"
      },
      "externalFrontends": {
        "items": {
          "properties": {
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "url"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "frontendComponents": {
        "deprecated": true,
        "items": {
          "properties": {
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "url"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "frontendFragments": {
        "additionalProperties": {
          "allOf": [
            {
              "properties": {
                "additionalProperties": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object"
                }
              },
              "type": "object"
            },
            {
              "oneOf": [
                {
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "url"
                  ],
                  "type": "object"
                }
              ]
            }
          ]
        },
        "type": "object"
      },
      "functional": {
        "type": "boolean"
      },
      "id": {
        "format": "uuid",
        "type": "string"
      },
      "logoRefId": {
        "description": "This is the FileId of the Logo. Retrieve the file with this id on `/v2/files/{logoRefId}`.",
        "format": "uuid",
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "pricing": {
        "oneOf": [
          {
            "description": "A price plan with (multiple) variants, including different prices for different included service descriptions",
            "items": {
              "properties": {
                "deletionDeadline": {
                  "format": "date-time",
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "isBookingStopped": {
                  "description": "If a variant is no longer bookable the existing extension instances will not be removed but no new ones can be created.",
                  "type": "boolean"
                },
                "isDeletionScheduled": {
                  "type": "boolean"
                },
                "key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "priceInCents": {
                  "description": "The monthly price in Euro Cents before tax.",
                  "type": "integer"
                }
              },
              "required": [
                "key",
                "priceInCents",
                "isBookingStopped",
                "isDeletionScheduled"
              ],
              "type": "object"
            },
            "type": "array"
          }
        ]
      },
      "pricingDetails": {
        "description": "The details section of the price plan. It informs if choosing different variants as a upgrade or downgrade is possible.",
        "properties": {
          "isDowngradeAllowed": {
            "type": "boolean"
          },
          "isUpgradeAllowed": {
            "type": "boolean"
          }
        },
        "required": [
          "isUpgradeAllowed",
          "isDowngradeAllowed"
        ],
        "type": "object"
      },
      "published": {
        "type": "boolean"
      },
      "requestedChanges": {
        "additionalProperties": false,
        "properties": {
          "context": {
            "enum": [
              "project",
              "customer"
            ],
            "type": "string"
          },
          "scopes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "webhookUrls": {
            "oneOf": [
              {
                "properties": {
                  "extensionAddedToContext": {
                    "properties": {
                      "url": {
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  "extensionInstanceRemovedFromContext": {
                    "properties": {
                      "url": {
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  "extensionInstanceSecretRotated": {
                    "properties": {
                      "url": {
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  "extensionInstanceUpdated": {
                    "properties": {
                      "url": {
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  }
                },
                "required": [
                  "extensionAddedToContext",
                  "extensionInstanceUpdated",
                  "extensionInstanceSecretRotated",
                  "extensionInstanceRemovedFromContext"
                ],
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {},
                "type": "object"
              }
            ]
          }
        },
        "type": "object"
      },
      "scopes": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "secrets": {
        "items": {
          "properties": {
            "secretId": {
              "format": "uuid",
              "type": "string"
            },
            "usableUntil": {
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "secretId"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "state": {
        "deprecated": true,
        "description": "deprecated",
        "enum": [
          "enabled",
          "blocked",
          "disabled"
        ],
        "type": "string"
      },
      "statistics": {
        "properties": {
          "amountOfInstances": {
            "description": "The amout of instances for this extension. Accurate for the Contributor. Publicly rounded to the next lower hundred.",
            "example": 42,
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "subTitle": {
        "description": "A few words to promote your Extension.",
        "properties": {
          "de": {
            "example": "Ping deine App an",
            "maxLength": 40,
            "type": "string"
          },
          "en": {
            "example": "Ping your app",
            "maxLength": 40,
            "type": "string"
          }
        },
        "required": [
          "de"
        ],
        "type": "object"
      },
      "support": {
        "allOf": [
          {
            "properties": {
              "email": {
                "example": "a.lovelace@example.com",
                "format": "email",
                "type": "string"
              },
              "phone": {
                "type": "string"
              }
            },
            "required": [
              "email"
            ],
            "type": "object"
          },
          {
            "properties": {
              "inherited": {
                "description": "Whether the support information is inherited from the contributor.",
                "type": "boolean"
              }
            },
            "required": [
              "inherited"
            ],
            "type": "object"
          }
        ]
      },
      "tags": {
        "items": {
          "type": "string"
        },
        "minItems": 0,
        "type": "array"
      },
      "verificationRequested": {
        "type": "boolean"
      },
      "verified": {
        "type": "boolean"
      },
      "webhookUrls": {
        "properties": {
          "extensionAddedToContext": {
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceRemovedFromContext": {
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceSecretRotated": {
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          },
          "extensionInstanceUpdated": {
            "properties": {
              "url": {
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "url"
            ],
            "type": "object"
          }
        },
        "required": [
          "extensionAddedToContext",
          "extensionInstanceUpdated",
          "extensionInstanceSecretRotated",
          "extensionInstanceRemovedFromContext"
        ],
        "type": "object"
      }
    },
    "required": [
      "id",
      "contributorId",
      "name",
      "statistics",
      "assets",
      "published",
      "verified",
      "verificationRequested",
      "functional",
      "secrets"
    ],
    "type": "object"
  },
  "type": "array"
}

Usage examples

cURL
JavaScript SDK
PHP SDK

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/contributors/string/extensions?limit=50&page=1

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.marketplace.extensionListOwnExtensions({
  "contributorId": "string",
  "queryParameters": {
    "limit": 50,
    "page": 1
  }
});

assertStatus(response, 200);
  

use \Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionListOwnExtensions\ExtensionListOwnExtensionsRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new ExtensionListOwnExtensionsRequest(
  contributorId: "string"
))
  ->withLimit(50)
  ->withPage(1);
$response = $client->marketplace()->extensionListOwnExtensions($request);

var_dump($response->getBody();
  

Request​

Path parameters required

Query parameters

Responses​

200 OK

Response headers

429 Too Many Requests

default

Usage examples​

Request

Responses

Usage examples