PHPackages prestashop/ps\_apiresources - 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. prestashop/ps\_apiresources ActivePrestashop-module[API Development](/categories/api) prestashop/ps\_apiresources =========================== PrestaShop - API Resources v0.5.0(3mo ago)11796.4k—9%41[1 issues](https://github.com/PrestaShop/ps_apiresources/issues)[45 PRs](https://github.com/PrestaShop/ps_apiresources/pulls)1AFL-3.0PHPPHP >=8.1CI passing Since Nov 25Pushed 1mo ago25 watchersCompare [ Source](https://github.com/PrestaShop/ps_apiresources)[ Packagist](https://packagist.org/packages/prestashop/ps_apiresources)[ Docs](https://github.com/PrestaShop/ps_apiresources)[ RSS](/packages/prestashop-ps-apiresources/feed)WikiDiscussions dev Synced 1mo ago READMEChangelog (5)Dependencies (6)Versions (16)Used By (1) PrestaShop API Resources ======================== [](#prestashop-api-resources) [![Coverage Status](https://camo.githubusercontent.com/3aeb6754992ebb8571af582de89ef83f7d6fd19a63607a9352dd2c23231a3ceb/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f50726573746153686f702f70735f6170697265736f75726365732f62616467652e737667)](https://coveralls.io/github/PrestaShop/ps_apiresources) About ----- [](#about) Includes the resources allowing using the API for the PrestaShop domain, all endpoints are based on CQRS commands/queries from the Core and we [API Platform](https://api-platform.com/) framework is used as a base. This module contains no code only some resource files that are automatically scanned and integrated by the Core, these resources are in [this folder](src/ApiPlatform/Resources). Reporting issues ---------------- [](#reporting-issues) You can report issues with this module in the main PrestaShop repository. [Click here to report an issue](https://github.com/PrestaShop/PrestaShop/issues/new/choose). Under development ----------------- [](#under-development) Please be aware that this module is still under development, which is why its version is only `0.*`. We haven't released a major version `1.0` yet because we anticipate some breaking changes may happen while we add all the missing endpoints. We aim to maintain backward compatibility as much as possible and never introduce breaking changes, but we also want this API contract to be a fixed standard once it's finalized, so we prefer to polish and refine it before a major version is released. After the `1.0` version is released it won't include other breaking changes, any breaking change will require a new major version (`2.0`) and will follow semver convention. Requirements ------------ [](#requirements) Required only for development: - composer Installation ------------ [](#installation) Install all dependencies. ``` composer install ``` Run tests locally ----------------- [](#run-tests-locally) ### Initialize tmp shop environment [](#initialize-tmp-shop-environment) First, initialize the test environment with this command that will install a PrestaShop shop in a temporary folder so that the integration tests can run: ``` composer create-test-db ``` ### Customize tmp shop environment [](#customize-tmp-shop-environment) You can define custom values when setting up the tmp shop: ``` composer clear-test-cache composer setup-local-tests -- [arguments] arguments: --force-clone Force cloning the repository even if a cloned repository is detected (when no repository is detected, the clone is automatic) --build-assets Force building assets even if they are already built (when no assets are detected, the build is automatic) --build-db Force building DB by installing the default shop data (when no DB is detected, the DB shop is installed automatically) --update-local-parameters Force copying parameters from the `test/local-parameters` folder (when no parameter file is detectec they are automatically copied) --force Force all the previous arguments --core-branch Use a specific branch, you can use a branch from the original repository (ex: `develop`, `9.0.x`, ...) or from a fork (ex: `myfork:my-dev-branch`) (By default branch develop is used) ``` Example: ``` # To test with 9.0.x branch composer setup-local-tests -- --force --core-branch=9.0.x # To test with a branch from your fork (in this example, fork: jolelievre, branch: product-api) composer setup-local-tests -- --force --core-branch=jolelievre:product-api ``` ### Run tests [](#run-tests) Then you can run the tests with this command: ``` composer run-module-tests ``` Run PHPStan locally ------------------- [](#run-phpstan-locally) You can run PHPStan locally using the composer script, you will need to specify two variables though: - `_PS_ROOT_DIR_`: path to a local PrestaShop root folder - `_PS_BRANCH_`: which branch you are testing, this impacts the PHPStan config file used which contains specific rules and exceptions, accepted values are `develop|9.1.x|9.0.x` ``` # To test with the develop branch _PS_ROOT_DIR_=/path/to/prestashop-develop _PS_BRANCH_=develop composer phpstan # To test with the 9.1.x branch _PS_ROOT_DIR_=/path/to/prestashop-91x _PS_BRANCH_=9.1.x composer phpstan # To test with the develop branch _PS_ROOT_DIR_=/path/to/prestashop-90x _PS_BRANCH_=9.0.x composer phpstan ``` Each config uses a différent cache folders stored in `var/phpstan-tmp` but you can easily pollute it if: - you run the command multiple times with mixed variables (`_PS_ROOT_DIR_` and `_PS_BRANCH_` don't match) - you change your branch in `_PS_ROOT_DIR_` but the cache was already generated with the previous branch You can remove the `var/phpstan-tmp` cache to reset the cache. You can also use the composer script to update the baseline to include exceptions for specific versions: ``` # To test with the develop branch (this should updated phpstan-9.0.x.neon only) _PS_ROOT_DIR_=/path/to/prestashop-90x _PS_BRANCH_=9.0.x composer phpstan-baseline ``` Make sure you use the correct two variables and your cache is correct ro you will add the wrong exceptions for the wrong branch. This composer script will generate a dedicated baseline file, but the rules should be included in the existing phpstan config for the branch. Contributing ------------ [](#contributing) The PrestaShop Admin API provides RESTful endpoints for managing your store programmatically. Everyone is welcome to contribute by adding new API endpoints! **Please read our contributing guide before starting:** - **[Create new API endpoints](https://devdocs.prestashop-project.org/9/admin-api/contribute-to-core-api/)** - Complete step-by-step guide - **[Admin API Documentation](https://devdocs.prestashop-project.org/9/admin-api/)** - Full API reference Need help or believe core improvements are needed? Reach out to the team on [Slack](https://prestashop-project.org/slack), and `#cfc-adminapi` channel - we're here to help! Also, follow our general [contribution guidelines](https://devdocs.prestashop-project.org/9/contribute/contribution-guidelines/project-modules/). License ------- [](#license) This module is released under the [Academic Free License 3.0](https://opensource.org/licenses/AFL-3.0) ### Health Score 54 — FairBetter than 97% of packages Maintenance85 Actively maintained with recent releases Popularity49 Moderate usage in the ecosystem Community33 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 53.8% 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 ~64 days Total 5 Last Release 90d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/15106407?v=4)[Jarvis](/maintainers/ps-jarvis)[@ps-jarvis](https://github.com/ps-jarvis) --- Top Contributors [![jolelievre](https://avatars.githubusercontent.com/u/13801017?v=4)](https://github.com/jolelievre "jolelievre (170 commits)")[![Codencode](https://avatars.githubusercontent.com/u/2463965?v=4)](https://github.com/Codencode "Codencode (24 commits)")[![boherm](https://avatars.githubusercontent.com/u/18699562?v=4)](https://github.com/boherm "boherm (19 commits)")[![tleon](https://avatars.githubusercontent.com/u/4093454?v=4)](https://github.com/tleon "tleon (19 commits)")[![nicosomb](https://avatars.githubusercontent.com/u/121870?v=4)](https://github.com/nicosomb "nicosomb (17 commits)")[![mattgoud](https://avatars.githubusercontent.com/u/99822883?v=4)](https://github.com/mattgoud "mattgoud (17 commits)")[![kpodemski](https://avatars.githubusercontent.com/u/2137763?v=4)](https://github.com/kpodemski "kpodemski (12 commits)")[![Jeremie-Kiwik](https://avatars.githubusercontent.com/u/129875339?v=4)](https://github.com/Jeremie-Kiwik "Jeremie-Kiwik (6 commits)")[![Touxten](https://avatars.githubusercontent.com/u/156076965?v=4)](https://github.com/Touxten "Touxten (4 commits)")[![kseghair](https://avatars.githubusercontent.com/u/16594134?v=4)](https://github.com/kseghair "kseghair (4 commits)")[![matks](https://avatars.githubusercontent.com/u/3830050?v=4)](https://github.com/matks "matks (4 commits)")[![Progi1984](https://avatars.githubusercontent.com/u/1533248?v=4)](https://github.com/Progi1984 "Progi1984 (3 commits)")[![jf-viguier](https://avatars.githubusercontent.com/u/16720275?v=4)](https://github.com/jf-viguier "jf-viguier (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![dylanDenizonPresta](https://avatars.githubusercontent.com/u/119846866?v=4)](https://github.com/dylanDenizonPresta "dylanDenizonPresta (3 commits)")[![jinpresta](https://avatars.githubusercontent.com/u/104894922?v=4)](https://github.com/jinpresta "jinpresta (2 commits)")[![sebajps](https://avatars.githubusercontent.com/u/125032396?v=4)](https://github.com/sebajps "sebajps (1 commits)")[![PrestaEdit](https://avatars.githubusercontent.com/u/2631425?v=4)](https://github.com/PrestaEdit "PrestaEdit (1 commits)")[![matthieu-rolland](https://avatars.githubusercontent.com/u/1784781?v=4)](https://github.com/matthieu-rolland "matthieu-rolland (1 commits)")[![ga-devfront](https://avatars.githubusercontent.com/u/52718717?v=4)](https://github.com/ga-devfront "ga-devfront (1 commits)") --- Tags apihacktoberfestprestashop-module ### Code Quality TestsPHPUnit Static AnalysisRector Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/prestashop-ps-apiresources/health.svg) ``` [![Health](https://phpackages.com/badges/prestashop-ps-apiresources/health.svg)](https://phpackages.com/packages/prestashop-ps-apiresources) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk PHP SDK for Facebook Business 90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 265103.1M454](/packages/google-gax)[google/common-protos Google API Common Protos for PHP 173103.7M50](/packages/google-common-protos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)