Playground: CRM API

Playground: CRM API

This package provides an API without UI for interacting with the Playground: CRM, a model package for Laravel.

If you need a JSON API with a UI, then have a look at Playground: CRM Resource.

Read more on using Playground: CRM API at Read the Docs: Playground Documentation

A postman collection is provided in the repository: postman-playground-crm-api.json.

• This same collection is viewable on the .

This application provides OpenAPI documentation: openapi.yaml.

• The endpoint models support locks, trash with force delete, restoring, revisions and more.
• Index endpoints support advanced query filtering.

OpenAPI API Documentation is built with npm using Redocly.

• npm is only needed to generate documentation and is not needed to operate the Playground: CRM API API.

See package.json requirements.

Install npm.

npm install

Build the documentation to generate the openapi.yaml configuration.

npm run docs

Documentation

• Preview openapi.yaml on the Redocly Editor UI.

You can install the package via composer:

composer require gammamatrix/playground-crm-api

Playground provides information in the artisan about command.

You can publish the config file with:

php artisan vendor:publish --provider="Playground\Crm\Api\ServiceProvider" --tag="playground-config"

All routes are enabled by default. They may be disabled via environment variable or the configuration.

See the contents of the published config file: config/playground-crm-api.php

You can publish the routes file with:

php artisan vendor:publish --provider="Playground\Crm\Api\ServiceProvider" --tag="playground-routes"

• The routes while be published in a folder at routes/playground-crm-api

If you are unable or do not want to publish configuration files for this package, you may override the options via system environment variables.

Information on environment variables is available on the wiki for this package

This package requires the migrations in playground-crm a Laravel package.

composer cloc

➜  playground-crm-api git:(develop) ✗ composer cloc
      0 text files.
      0 unique files.
      0 files ignored.

github.com/AlDanial/cloc v 1.98  T=0.0 s (0.0 files/s, 0.0 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
JSON                             0              0              0              0
PHP                              0              0              0              0
YAML                             0              0              0              0
XML                              0              0              0              0
Markdown                         0              0              0              0
INI                              0              0              0              0
-------------------------------------------------------------------------------
SUM:                             0              0              0              0
-------------------------------------------------------------------------------

Tests at level 10 on:

• config/
• routes/
• src/
• tests/Feature/
• tests/Unit/

composer analyse

composer format

Run unit tests:

composer test

Run unit and feature tests:

composer test-dev

Run unit and feature tests in parallel:

composer test-parallel

Please see CHANGELOG for more information on what has changed recently.

The MIT License (MIT). Please see License File for more information.