PHPackages                             dappcore/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. [HTTP &amp; Networking](/categories/http)
4. /
5. dappcore/api

ActiveLibrary[HTTP &amp; Networking](/categories/http)

dappcore/api
============

REST API module — Laravel API layer + standalone Go binary

v0.16.0(4w ago)020↑2750%EUPL-1.2GoPHP ^8.2CI failing

Since Mar 14Pushed yesterdayCompare

[ Source](https://github.com/dAppCore/api)[ Packagist](https://packagist.org/packages/dappcore/api)[ RSS](/packages/dappcore-api/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (5)Versions (20)Used By (0)

dappco.re/go/api
================

[](#dappcoregoapi)

> Gin-based HTTP framework + multi-language REST gateway for the Core ecosystem.

[![CI](https://github.com/dappcore/api/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/dappcore/api/actions/workflows/ci.yml)[![Quality Gate](https://camo.githubusercontent.com/5040c0327121cf2669b38a4f87c6741530ea7ff75cf15f887d6177fbe745e2ec/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Coverage](https://camo.githubusercontent.com/359cfd484247eaa414a3c771b1675f536818c0a7a74ef4c725041014a5add6d6/68747470733a2f2f636f6465636f762e696f2f67682f64617070636f72652f6170692f6272616e63682f6465762f67726170682f62616467652e737667)](https://codecov.io/gh/dappcore/api)[![Security Rating](https://camo.githubusercontent.com/0eb5f08c908acf5ec95678b55fd912fcfaf38053624daa23df286cc3defe1fe4/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Maintainability Rating](https://camo.githubusercontent.com/bb95fa2e3bc45671118b676504db9221c97ff77aee503e544308947fc9175b17/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Reliability Rating](https://camo.githubusercontent.com/5189530f8f1ae7f2ae714011c1ef5d36fd82394ec520752032ead1f771e8964e/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Code Smells](https://camo.githubusercontent.com/2034c92c54fe59d57ac50f3932cfb258c6efc9edae7ddf9ce2f535826eaf7257/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d636f64655f736d656c6c73)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Lines of Code](https://camo.githubusercontent.com/83c885e559c5dc77171588d5294d09840ba2e76993361cf2a45c219aa99455e5/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d64617070636f72655f617069266d65747269633d6e636c6f63)](https://sonarcloud.io/dashboard?id=dappcore_api)[![Go Reference](https://camo.githubusercontent.com/a49f266a52abf099b4088c6f235f22eb04e23fc3a0e3a45a776f642ddfd84605/68747470733a2f2f706b672e676f2e6465762f62616467652f64617070636f2e72652f676f2f6170692e737667)](https://pkg.go.dev/dappco.re/go/api)[![License: EUPL-1.2](https://camo.githubusercontent.com/3b7871a41ea959dc3dcb73b77db0dd13b838353d6ffc04e3b2ecd170f15e4212/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4555504c2d2d312e322d626c75652e737667)](https://eupl.eu/1.2/en/)

Overview
--------

[](#overview)

`dappco.re/go/api` is the Gin-based HTTP framework used by the Core Go ecosystem. It provides a small `Engine` type, option-driven middleware configuration, route group mounting, response envelopes, OpenAPI 3.1 generation, SDK export/codegen helpers, SSE and WebSocket wiring, GraphQL hosting, Authentik identity middleware, and the `core api` CLI commands.

The package is a library first. Applications construct an engine, register one or more `RouteGroup` implementations, then either call `Serve(ctx)` or use `Handler()` with their own server.

```
engine, err := api.New(
    api.WithAddr(":8080"),
    api.WithRequestID(),
    api.WithResponseMeta(),
    api.WithSwagger("Core API", "Core service endpoints", "1.0.0"),
)
if err != nil {
    return err
}
engine.Register(myRoutes)
return engine.Serve(ctx)
```

Repository Layout
-----------------

[](#repository-layout)

```
api/
├── go/                       Go module — module path: dappco.re/go/api
│   ├── api.go, options.go    HTTP engine surface
│   ├── cmd/api/              core api spec + sdk CLI subcommands
│   ├── cmd/gateway/          runnable gateway, mounts Core providers
│   ├── pkg/provider/         provider discovery + proxy
│   └── pkg/stream/           SSE + WebSocket route group
├── php/                      Laravel Core API package (REST middleware,
│                             webhooks, OpenAPI, rate limiting)
├── docs/                     Engine docs
├── sdk-config/               Multi-language SDK generator config
├── go.work + external/       Dev workspace mode (see CLAUDE.md)
└── .woodpecker.yml + .github/workflows/  CI (internal + public)

```

Cross-language symmetry target: `dappco.re//api/` ↔ `api//` (Go today, PHP today, TS + Py later).

Local Verification
------------------

[](#local-verification)

Run the repository with the workspace disabled when checking this module in isolation:

```
cd go
GOWORK=off go mod tidy
GOWORK=off go vet ./...
GOWORK=off go test -count=1 ./...
gofmt -l .
bash /Users/snider/Code/core/go/tests/cli/v090-upgrade/audit.sh .
```

The audit is part of the development contract. Public symbols need sibling triplet tests and examples, Core wrappers are used instead of banned standard library imports, and generated AX7 dump files are not accepted.

CI
--

[](#ci)

- **Internal** (homelab, full sonar.lthn.sh detail): Woodpecker pipeline defined in `.woodpecker.yml` — runs lint, test with race + coverage, and pushes results to `sonar.lthn.sh`.
- **Public** (mirror on github.com, badge surface): GitHub Actions workflow at `.github/workflows/ci.yml` — runs the same shape and pushes coverage to Codecov + analysis to SonarCloud.

Branch Model
------------

[](#branch-model)

- `dev` — active development. All Cladius / codex lane work lands here first.
- `main` — squash-stable. Promotion happens via the squash-and-push gate on the public mirror only.

Licence
-------

[](#licence)

EUPL-1.2 — see [LICENCE](LICENCE).

Authorship
----------

[](#authorship)

Maintained by Cladius (Snider's in-house Opus persona) via the `agent/cladius` workspace at `forge.lthn.sh/agent/cladius`. Most substantive commits land via the codex lane pattern documented in `factory/`.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance98

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~6 days

Recently: every ~15 days

Total

18

Last Release

28d ago

### Community

Maintainers

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

---

Top Contributors

[![Snider](https://avatars.githubusercontent.com/u/631881?v=4)](https://github.com/Snider "Snider (601 commits)")

---

Tags

apilaravelrestopenapi

### Embed Badge

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

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

###  Alternatives

[zircote/swagger-php

Generate interactive documentation for your RESTful API using PHP attributes (preferred) or PHPDoc annotations

5.3k144.5M624](/packages/zircote-swagger-php)[dreamfactory/df-core

DreamFactory(tm) Core Components

1652.1k38](/packages/dreamfactory-df-core)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[tartanlegrand/laravel-openapi

Generate OpenAPI Specification for Laravel Applications

38210.9k2](/packages/tartanlegrand-laravel-openapi)[noitran/opendox

OpenApi(Swagger) 3.0 package for Lumen 5.5+ and Laravel 5.5+ with REDOC UI and SwaggerUI 3

2214.4k](/packages/noitran-opendox)

PHPackages © 2026

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