Maintained fork of krayin/rest-api (Laravel 12 + fixes + tests) now on Packagist

[tuaititecnologia]

Hi everyone 👋

Like a lot of you, I rely on Krayin's REST API (krayin/rest-api) to integrate the CRM with other systems. Running it on Laravel 12 I hit a wall — the package targets Laravel 11 — and along the way I ran into several endpoint bugs already reported in this repo.

Rather than patching locally, I turned the work into a community-maintained fork and published it so others can skip the same pain:

📦 Packagist: tuaititecnologia/krayin-rest-api
🔗 GitHub: https://github.com/tuaititecnologia/krayin-rest-api

It's a drop-in replacement — same Webkult declares replace: krayin/rest-api`, so noapplication code changes are needed:

composer require tuaititecnologia/krayin-rest

What it does

• ✅ Laravel 12 compatibility (the original targets Laravel 11)
• ✅ Fixes across many endpoints reported here — Leads, Contacts (persons/organizations), Activities (participants
  finally link), Mail, Products, Quotes, and moributes, tags, roles, groups, web forms,webhooks, pipelines, email templates, types, sources, marketing events/campaigns)
• ✅ Custom (EAV) fields are now returned by Lead / Person / Organization responses
• ✅ Cleaner error contract — guests get a JSON 401 instead of a crash, 404/422 instead of 500s
• ✅ A real test suite (Unit / Feature / Integration) + CI on PHP 8.2 / 8.3 / 8.4, plus an integration job that provisions a live Krayin and exercises the real API

Requirements: Krayin v2.x on Laravel 12, PHP 8.2+ (details in the README).

It stays MIT, same license as Krayin, and team for the original — this is meant ascommunity maintenance, and I'm glad to send fixes back upstream too.

Changelog: https://github.com/tuaititecnologin/CHANGELOG.md

Feedback, issues and PRs very welcome. If you've been blocked on a REST API bug, give it a try and let me know if it unblocks you 🙏

[sagarkumar-webkul]

Hi @tuaititecnologia,

Thank you for your contribution to the Krayin community and for taking the time to improve the REST API package. We really appreciate the effort you've put into adding Laravel 12 compatibility, fixing reported issues, and improving the test coverage.

If possible, we'd encourage you to open a Pull Request against the official Krayin REST API repository with your changes. Our team will review the PR, test the changes thoroughly, and discuss merging the improvements upstream where appropriate.

Thanks again for your valuable contribution—we look forward to reviewing your PR!

[tuaititecnologia]

Thanks for the encouragement! I've opened the PR: krayin/rest-api#166

It's organized into three reviewable commits and is backward compatible for existing /v1/ consumers:

1. Laravel 12 support — bumps l5-swagger to ^9.0, migrates the OpenAPI docs to the PHP 8 attribute syntax it requires, updates the exception handler, and adds explicit php ^8.2 / sanctum ^4.0 constraints.
2. Test suite + CI — an Orchestra Testbench suite (83 tests, no full CRM needed) with a GitHub Actions matrix on PHP 8.2/8.3/8.4, plus an optional live-Krayin integration job.
3. JSON error contract + endpoint fixes — a consistent JSON error/404/422/403 contract, a centralized CRUD/list layer (allow-listed sort/filter, real HTTP status codes, no more 500s on bad input), and per-module fixes across Lead, Contact, Activity, Mail, Product, Quote and Settings. The PR description groups the reported issues it addresses by module.

Happy to split it into smaller PRs (e.g. Laravel 12 support first, then the endpoint sweep) if that's easier to review — just let me know what works best for your team. Thanks again for maintaining Krayin!