mittwald/api-client

Client library for the mittwald mStudio v2 API

v2.1.20 2024-04-26 00:09 UTC

Requires

• php: ^8.2
• caseyamcl/guzzle_retry_middleware: ^2.9
• guzzlehttp/guzzle: ^7.8
• justinrainbow/json-schema: ^5.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.25
• phpunit/phpunit: ^10.5
• rector/rector: ^0.19.8
• vimeo/psalm: ^5.15

MIT

• Martin Helmich

README

This package contains a (mostly auto-generated) PHP client for the mittwald mStudio v2 API.

License

Copyright (c) 2023 Mittwald CM Service GmbH & Co. KG and contributors

This project is licensed under the MIT License; see the LICENSE file for details.

Installation

You can install this package using composer:

$ composer require mittwald/api-client

Usage

Import the client:

use Mittwald\ApiClient\MittwaldAPIV2Client;

To create a client instance you can use one of the following factory methods for different types of authentication:

1. MittwaldAPIClient::newUnauthenticated()
2. MittwaldAPIClient::newWithToken(string $apiToken) (recommended)
3. MittwaldAPIClient::newWithCredentials(string $email, string $password) (does actually perform a login in the background; does not work when using 2FA)

Have a look at our API introduction for more information on how to obtain an API token and how to get started with the API.

Example

use \Mittwald\ApiClient\Generated\V2\Clients\Project\ListProjects\ListProjectsRequest;

$listProjectRequest = new ListProjectsRequest();
$listProjectResponse = $client->project()->listProjects($listProjectRequest);

foreach ($listProjectResponse->getBody() as $project) {
    echo $project->getShortId() . PHP_EOL;
}

API documentation

The API documentation can be found in our Developer Portal. You can find the operation ID on the right side of each operation.