PHPackages                             simplia/api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. simplia/api

ActiveLibrary[API Development](/categories/api)

simplia/api
===========

0.1.31(5mo ago)065.7k↓67.8%1PHPPHP >=7.4

Since Mar 10Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/simplia/api-php-sdk)[ Packagist](https://packagist.org/packages/simplia/api)[ RSS](/packages/simplia-api/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (10)Dependencies (4)Versions (56)Used By (0)

SDK pro API eshopů Simplia.cz () určené pro interní napojení. Automaticky generováno z [OpenAPI](https://api.simplia.cz/swagger.json) definic.

Výhody oproti přímému použití REST API:

- možnost statické analýzy ([PHPStan](https://phpstan.org/)) a odladění problému bez nutnosti volat API
- jednodušší testování (komunikace s SDK se mockuje jednodušeji než celá HTTP komunikace)
- napovídání v editoru

Installing
----------

[](#installing)

```
composer require simplia/api:dev-master
```

Contributing
------------

[](#contributing)

Celý repozitář je automaticky generován z OpenAPI definic a pull request je potřeba poslat pro generátoru (nebo jen popsat problém v issue zde)

Terminology
-----------

[](#terminology)

- *\_\_\_Endpoint* - kategorie operací
- *\_\_\_Request* - parametry výpisu jako je řazení, filtry, ...
- *\_\_\_FieldConfig* - seznam polí, které se mají získat z backendu
- *\_\_\_Input* - vstup pro operaci jako například nový popis produktu apod, který se pošle jako tělo API požadavku

Examples
--------

[](#examples)

#### Create new order

[](#create-new-order)

```
use \Simplia\Api\Api;
use \Simplia\Api\Input\AddressTypeApiInput;
use \Simplia\Api\Input\OrderCreateTypeApiInput;
use \Simplia\Api\Input\OrderItemTypeApiInput;
use \Simplia\Api\Entity\OrderApiEntity;

$api = Api::withUsernameAuth($httpClient, 'demo2.simpliashop.cz', 'api_user', '*********');
$order = $api->getOrdersEndpoint()->create(
    OrderCreateTypeApiInput::create()
        ->setDeliveryAddress(
            AddressTypeApiInput::create()
                ->setFirstName('John')
                ->setLastName('Smith')
                ->setCity('Prague')
                ->setEmail('info@example.org')
        )
        ->setCustomerNote('customer note')
        ->setItems([
            OrderItemTypeApiInput::create()
            ->setItemId(123)
            ->setQuantity(2)
            ->setPriceVat(200) // unit price with vat
        ]),
    OrderApiEntity::createFieldConfig()
        ->withId()
);

echo $order->getId();
```

#### Change order status

[](#change-order-status)

```
use \Simplia\Api\Api;
use \Simplia\Api\Input\OrderStatusTypeApiInput;

$api = Api::withUsernameAuth($httpClient, 'demo2.simpliashop.cz', 'api_user', '*********');
$api->getOrdersEndpoint()->updateStatus(
    '123',
    OrderStatusTypeApiInput::create()
        ->setStatusId(4)
);
```

#### List orders from status by name

[](#list-orders-from-status-by-name)

```
use \Simplia\Api\Api;
use \Simplia\Api\Entity\ContactApiEntity;
use \Simplia\Api\Entity\OrderApiEntity;
use \Simplia\Api\Request\OrderApiRequest;

$api = Api::withUsernameAuth($httpClient, 'demo2.simpliashop.cz', 'api_user', '*********');
$orders = $api->getOrdersEndpoint()->iterate(
    OrderApiRequest::create()
        ->whereStatus(1),
    OrderApiEntity::createFieldConfig()
        ->withId()
        ->withDeliveryAddress(
            ContactApiEntity::createFieldConfig()
                ->withCompanyName()
        )
);

foreach ($orders as $order) {
    echo $order->getId();
    echo $order->getDeliveryAddress()->getCompanyName();
}
```

#### Get single order

[](#get-single-order)

```
use \Simplia\Api\Api;
use \Simplia\Api\Entity\ContactApiEntity;
use \Simplia\Api\Entity\OrderApiEntity;

$api = Api::withUsernameAuth($httpClient, 'demo2.simpliashop.cz', 'api_user', '*********');
$order = $api->getOrdersEndpoint()->get(
   '123',
    OrderApiEntity::createFieldConfig()
        ->withId()
        ->withDeliveryAddress(
            ContactApiEntity::createFieldConfig()
                ->withCompanyName()
        )
);

echo $order->getId();
echo $order->getDeliveryAddress()->getCompanyName();
echo $order->getCurrency(); // throws error because currency with wasn't loaded from API (is not defined in field config)
```

#### Article list by topic

[](#article-list-by-topic)

```
use \Simplia\Api\Api;
use \Simplia\Api\Request\ArticleApiRequest;
use \Simplia\Api\Entity\ArticleApiEntity;

$api = Api::withUsernameAuth($httpClient, 'demo2.simpliashop.cz', 'api_user', '*********');
$articles = $api->getArticlesEndpoint()->iterate(
    ArticleApiRequest::create()
        ->whereTopic(7)
        ->orderByPublishedAsc(),
    ArticleApiEntity::createFieldConfig()
        ->withName()
        ->withUrl()
);

foreach ($articles as $article) {
    echo '' . $article->getName() . '';
}
```

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance72

Regular maintenance activity

Popularity30

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Recently: every ~52 days

Total

55

Last Release

160d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/704500?v=4)[petrsoukup](/maintainers/petrsoukup)[@petrsoukup](https://github.com/petrsoukup)

---

Top Contributors

[![landsman](https://avatars.githubusercontent.com/u/3184228?v=4)](https://github.com/landsman "landsman (1 commits)")[![soukicz](https://avatars.githubusercontent.com/u/1814750?v=4)](https://github.com/soukicz "soukicz (1 commits)")

### Embed Badge

![Health badge](/badges/simplia-api/health.svg)

```
[![Health](https://phpackages.com/badges/simplia-api/health.svg)](https://phpackages.com/packages/simplia-api)
```

###  Alternatives

[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60316.6M98](/packages/mollie-mollie-api-php)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M777](/packages/sylius-sylius)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

36826.2k2](/packages/telnyx-telnyx-php)[toshy/bunnynet-php

BunnyNet API client for PHP

61220.4k15](/packages/toshy-bunnynet-php)[jane-php/open-api-runtime

Jane OpenAPI Runtime Library, dependencies and utility class for a library generated by jane/openapi

2111.9M136](/packages/jane-php-open-api-runtime)[wordpress/php-ai-client

A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.

26554.3k27](/packages/wordpress-php-ai-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)