API Developer Tools für API Developers, Platform Engineers und API-Entwickler, die Developer Experience ernst nehmen. CLI, REST API und native CI/CD-Plugins für GitHub Actions, GitLab CI und Jenkins — OpenAPI, AsyncAPI und GraphQL aus jeder Pipeline deployen.
$ apiportal deploy --env production
✓ Uploading OpenAPI spec... done
✓ Validating schema... passed (0 errors)
✓ Generating documentation... done
✓ Running linter checks... passed
✓ Publishing to portal... done
✓ Deployed successfully!
→ https://app.api-portal.io/docs/payment-api/v3
$
// Native CI/CD Plugins
API Portal läuft dort, wo dein Team entwickelt — direkt im Merge-Request. Spec-Validierung, Breaking-Change-Detection und automatisches Deployment für OpenAPI, AsyncAPI und GraphQL — mit nativen Plugins für GitHub Actions, GitLab CI und Jenkins.
# .github/workflows/deploy.yml
name: Deploy API Spec
on: [push]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: apiportal/deploy@v1
with:
file: openapi.yaml
env: production
# .gitlab-ci.yml
stages:
- deploy
deploy_api:
stage: deploy
image: apiportal/cli:latest
script:
- apiportal login --token $PAT
- apiportal push --file openapi.yaml
- apiportal deploy --env production
only:
- main
// Jenkinsfile
pipeline {
agent any
stages {
stage('Deploy API') {
steps {
sh '''
apiportal login \
--token $PAT
apiportal deploy \
--file openapi.yaml \
--env production
'''
} } } }
// Workflow
OpenAPI, AsyncAPI oder GraphQL direkt neben dem Code. Kein Medienbruch, kein Portal-Upload — Spec lebt dort, wo auch der Rest der API entsteht.
GitHub Actions, GitLab CI oder Jenkins führen Linter- und Breaking-Change-Checks im Merge-Request aus. Bei Merge pusht die Pipeline die Spec ins API Portal — versioniert und signiert.
Nutzung, Änderungen und Zugriffe fließen in Audit-Log und API Intelligence. Volle Nachvollziehbarkeit ab dem ersten Commit.
// Toolkit
Das API Portal CLI ist das zentrale Werkzeug für die Verwaltung von APIs direkt aus dem Terminal — OpenAPI, AsyncAPI und GraphQL gleichermaßen. Login, Upload, Validierung und Environment-Management in einem Befehl. Ideal für Platform Engineering und DevOps-Teams, die API-Deployments als Code verwalten und Developer Experience ernst nehmen.
$ apiportal login
✓ Authenticated as your@email.com
$ apiportal push --file openapi.yaml
✓ Uploading openapi.yaml... done
✓ Version v2.4.0 created
$ apiportal validate openapi.yaml
✓ Schema valid (0 errors, 0 warnings)
$ apiportal environments list
production ● active v2.4.0
staging ● active v2.5.0-beta
development ● idle v2.5.0-dev
$
Die vollständige Management API basiert auf OpenAPI 3.1.0 und bietet programmatischen Zugriff auf alle Portal-Funktionen — Katalog, Versionierung, Zugriffskontrolle, Workflow Design und Spec-Management für OpenAPI, AsyncAPI und GraphQL. Perfekt für eigene Automatisierungen, Custom-Integrationen und CI/CD-Skripte in jeder Sprache.
GET /api/management/v1/capabilities
Authorization: Bearer eyJhbGci...kpXVCJ9
X-Tenant-ID: tenant-netscale-prod
// Response 200 OK
{
"data": [
{
"id": "cap_payment_api",
"name": "Payment API",
"version": "3.1.0",
"status": "published"
}
],
"cursor": "eyJpZCI6MTB9"
}
Personal Access Tokens ermöglichen sichere, granulare Authentifizierung für CLI, REST API und CI/CD-Pipelines. Scope-Kontrolle, Ablaufdaten und sofortiges Revoke — alles auditierbar.
| Name | Scopes | Ablaufdatum | |
|---|---|---|---|
| CI/CD Pipeline | read write | 2026-06-15 | Widerrufen |
| Local Dev | read | 2026-04-01 | Widerrufen |
| Admin Tools | read write admin | 2026-12-31 | Widerrufen |
// Für wen
API Developer Tools sind für Teams gemacht, die Platform Engineering und Developer Experience (DevEx) nicht dem Zufall überlassen — sondern automatisieren.
// Vergleich
Viele API-Teams arbeiten mit Postman-Collections, curl-Scripts oder manuellen Uploads im Portal. Das skaliert nicht — spezialisierte API Developer Tools lösen drei Kernprobleme.
HTTP-Clients für Exploration, aber kein API-Lifecycle-Management. Keine CI/CD-Integration, keine Spec-Validierung im Merge-Request, keine Versionierung.
Developer Tools: Pipeline-Integration mit Breaking-Change-Check.
Funktionieren für 5 APIs, werden bei 50 unwartbar. Keine Authentifizierung, keine Standardisierung, keine Audit-Logs — jedes Team kocht sein eigenes Süppchen.
Developer Tools: Standardisierte CLI mit PAT und Audit-Trail.
Developer muss sich einloggen, Datei wählen, hochladen — bei jeder Änderung. Kein Git-Workflow, kein Review-Prozess, keine Automation.
Developer Tools: git push → CI validiert → Portal deployed.
// FAQ
Kurz beantwortet für Platform-Engineers und DevOps-Teams.
Kontakt aufnehmen// Mehr entdecken
// Vertiefen
CLI, Pipeline-Integration und Spec-First-Methodik.
Pipeline-First API-Deployment — von Pre-Upload-Validierung bis automatisiertem Versions-Management.
Artikel lesenWie das Tooling in einen Spec-First-Workflow eingebettet wird.
Artikel lesenTry-it-out, Mocks und Code-Samples als sichtbares Ergebnis der Tooling-Kette.
Artikel lesenStarte mit CLI, REST API und CI/CD-Integration — und bring deine API-Workflows auf das nächste Level.