TELEKOMMUNIKATION

API-Management für Tele­kommunikation.
Von TM Forum Open APIs bis zum Partnerportal.

Produktkatalog, Bestellung, Inventar und Netz-APIs verteilen sich bei Netzbetreibern meist auf viele Systeme und Versionen. Das API Portal führt ihre Specs in einem Katalog zusammen und gibt Partnern genau die Schnittstellen frei, die sie brauchen.

v4 + v5
TMF-Specs nebeneinander
EU
Hosting in Frankfurt
SSO
Okta, Azure AD, Keycloak
app.api-portal.io/telco
Telco TM Forum CAMARA
TMF620 v5
Product Catalog
TMF622 v4
Product Ordering
TMF638 Wholesale
Service Inventory
CAMARA
SIM Swap
Bereit für die Specs dieser Standards
TM Forum Open APIs CAMARA OpenAPI 3.x Swagger 2.0 AsyncAPI

// Die Herausforderung

Warum Telekommunikationsanbieter ein
API Portal brauchen.

Die Geschäfts-IT eines Netzbetreibers ist selten aus einem Guss. CRM, Bestellung, Inventar und Netz stammen von verschiedenen Herstellern, und jede Schnittstelle hat ihre eigenen Konsumenten im Haus und bei Partnern.

TMF-APIs in v4 und v5 zugleich

Das Bestellsystem spricht TMF622 in v4, der neue Produktkatalog TMF620 schon in v5, und beide tragen eigene Erweiterungen. Welcher Stand wo live ist, weiß in der Regel nur das Team, das die Schnittstelle betreibt.

Wholesale-Partner ohne Self-Service

Reseller, MVNOs und Wholesale-Kunden bestellen über Ordering- und Qualification-APIs. Die Dokumentation dazu geht häufig als PDF hinaus, und jede neue Version löst eine Runde Rückfragen aus.

Netz-APIs für externe Entwickler

Mit CAMARA und GSMA Open Gateway kommen Konsumenten hinzu, die das Netz nicht kennen. Sie brauchen eine Spec, die sie im Browser ausprobieren können, und einen klaren Weg zum Zugang.

// Use Cases

Gemacht für
Netzbetreiber und Telco-Plattformen.

TM Forum Open APIs

TM Forum Open APIs im Katalog zusammenführen.

Das TM Forum veröffentlicht seine Open APIs als Spec-Dateien, Version 4 als Swagger 2.0 und Version 5 als OpenAPI 3.0. Der Katalog nimmt beide Formate auf, sodass TMF620, TMF622 oder TMF641 mit euren Erweiterungen neben den eigenen APIs stehen. Teams sehen dort auf einen Blick, welches System welche Version anbietet.

  • Swagger 2.0 und OpenAPI 3.x im selben Katalog
  • Versionsvergleich zwischen v4 und v5
  • Hausregeln und TMF630-Vorgaben als Custom Rules im Linter
API-Katalog ansehen →
app.api-portal.io/telco/tmf620/diff
v4.1.0 · Swagger 2.0 → v5.0.0 · OpenAPI 3.0
GET/productOffering
GET/catalogBreaking
GET/productCatalogv5
GET/productOfferingPrice/{id}
POST/importJob
Partner & Wholesale

Partnerportale für Wholesale, Reseller und MVNOs.

Jede Partnergruppe bekommt ein eigenes Portal mit ihren Ordering-, Qualification- und Inventory-APIs. Business Groups und Rollen legen fest, wer welche Spec sieht, und neue Versionen erscheinen dort mit Changelog.

  • Eigenes Portal je Partnergruppe
  • Zugriff je Business Group und Rolle
  • White Label mit eigener Domain
Enterprise Portale ansehen →
wholesale.telco-partner.example
TMF645
Service Qualification
TMF622
Product Ordering
TMF638
Service Inventory
AsyncAPI
Order Events
Netz-APIs

Netz-APIs nach CAMARA verständlich bereitstellen.

CAMARA beschreibt Netz-APIs wie SIM Swap, Number Verification oder Quality on Demand als OpenAPI-Specs, und über GSMA Open Gateway bieten Betreiber sie einheitlich an. Im Portal lassen sich diese Specs dokumentieren, im Explorer ausprobieren und je Meta-Release versionieren.

  • Try-it-out im API Explorer
  • Versionen je CAMARA-Meta-Release
  • Getrennte Sichten für interne Teams und externe Entwickler
API Explorer ansehen →
app.api-portal.io/telco/network-apis
POST/checkSIM Swap
POST/retrieve-dateSIM Swap
POST/verifyNumber Verification
POST/sessionsQuality on Demand
GET/sessions/{sessionId}Quality on Demand

// Sicherheit & Betrieb

Bereit für
kritische Infrastruktur.

Telekommunikationsnetze zählen zur kritischen Infrastruktur, und NIS2 und TKG stellen hohe Anforderungen an ihre Systeme. Das Portal bringt dafür Bausteine mit, die in eure Sicherheitskonzepte einfließen können.

Zugriff nach Rollen

Rollen, Business Groups und Environment Policies legen fest, wer welche API sieht und ändern darf. Angemeldet wird per SSO über Okta, Azure AD oder Keycloak.

Audit-Logs für jede Änderung

Wer wann welche Spec geändert hat, steht im Audit-Log. Das gibt internen Reviews und externen Prüfungen eine nachvollziehbare Grundlage.

On-Premise möglich

Im Enterprise-Plan läuft die Plattform auf Wunsch auch in eurer eigenen Infrastruktur.

Hosting in Frankfurt

Die Cloud-Variante läuft in EU-Rechenzentren in Frankfurt, die Daten bleiben in der EU.

// API-Landschaft

Typische Telco-APIs
im Portal verwalten.

Die Beispiele reichen vom Produktkatalog über die Bestellung bis zu den Netz-APIs. Die Pfade stammen aus den veröffentlichten Specs von TM Forum und CAMARA.

REST TMF620 v5

Product Catalog Management

Produktangebote, Preise und Kategorien, die CRM, Shop und Partnerkanäle gemeinsam nutzen.

GET /productOffering
GET /productOfferingPrice/{id}
REST TMF622 v5

Product Ordering

Bestellungen von Endkunden und Partnern mit Positionen, Status und Stornierung.

POST /productOrder
POST /cancelProductOrder
REST TMF645 v5

Service Qualification

Prüft vor der Bestellung, ob ein Dienst an einer Adresse oder einem Anschluss verfügbar ist.

POST /checkServiceQualification
GET /checkServiceQualification/{id}
Swagger 2.0 TMF641 v4.2

Service Ordering

Technische Aufträge an das Netz, etwa die Aktivierung oder Änderung eines Dienstes.

POST /serviceOrder
GET /serviceOrder/{id}
REST CAMARA

SIM Swap

Meldet, ob und wann die SIM-Karte zu einer Rufnummer zuletzt getauscht wurde, etwa zur Betrugsprävention.

POST /check
POST /retrieve-date
REST CAMARA

Quality on Demand

Fordert für eine Sitzung eine bestimmte Netzqualität an und fragt ihren Status ab.

POST /sessions
GET /sessions/{sessionId}

// Architektur

Passt in die OSS/BSS-Landschaft.

In einer ODA-Architektur bietet jede Komponente ihre Funktionen über Open APIs an, und auch Bestandssysteme liefern ihre Specs meist aus dem eigenen Repository. Über CLI und CI/CD landen diese Specs bei jedem Release im Portal, ohne dass jemand sie von Hand hochlädt.

  • CI/CD mit GitHub Actions, GitLab CI und Jenkins
  • CLI und REST-API für die Automatisierung
  • AsyncAPI für Event- und Notification-Schnittstellen
  • SSO per SAML mit dem Corporate Directory
  • On-Premise im Enterprise-Plan
gitlab-ci.yml

# .gitlab-ci.yml · Telco API Portal Sync

stages:

  - validate

  - deploy

validate-specs:

  stage: validate

  script:

    - apiportal lint ./specs/tmf/*.yaml

    - apiportal lint ./specs/camara/*.yaml

deploy-portal:

  stage: deploy

  script:

    - apiportal deploy --env prod

  only:

    - main

// FAQ

Häufige Fragen aus der Telekommunikation.

Noch Fragen? Unser Team hilft gerne weiter.

Vertrieb kontaktieren
Ja. Das TM Forum veröffentlicht Version 4 seiner Open APIs als Swagger 2.0 und Version 5 als OpenAPI 3.0, und beide Formate nimmt der Katalog auf. Jede Version wird separat geführt, und der Versionsvergleich zeigt, welche Felder und Endpoints sich zwischen zwei Ständen geändert haben. Eigene Erweiterungen bleiben dabei Teil der jeweiligen Spec.
Über Rollen und Business Groups legst du fest, welche APIs ein Partner sieht. Mit Enterprise Portale bekommt jede Partnergruppe zudem ein eigenes Portal, auf Wunsch im eigenen Branding und unter eigener Domain. Neue Partner lädst du per E-Mail ein und weist ihnen direkt Rolle und Business Group zu.
Ja. CAMARA beschreibt seine APIs als OpenAPI-3.0-Specs, die sich wie jede andere Spec in den Katalog aufnehmen und im API Explorer ausprobieren lassen. Consent, Authentifizierung und Abrechnung laufen weiterhin über das Netz und das Gateway des Betreibers.
Nein. Das Gateway nimmt die Aufrufe entgegen und setzt Limits und Authentifizierung durch. Das Portal verwaltet die Specs, die Dokumentation und den Zugriff darauf, damit interne Teams und Partner die richtige Schnittstelle finden und verstehen. In der Regel arbeiten beide nebeneinander.
Das Portal bringt Bausteine mit, die Betreiber für ihre Sicherheitskonzepte nach NIS2 und TKG brauchen. Dazu gehören Rollen und Rechte je API, SSO, Audit-Logs für jede Änderung und Hosting in der EU. Wie diese Bausteine in das eigene Konzept einfließen und was davon nachzuweisen ist, bewertet der Betreiber selbst.
Ja, im Enterprise-Plan ist der Betrieb in eurer eigenen Infrastruktur möglich. Welche Variante passt, klären wir am besten in einem Gespräch über eure Umgebung.

Sprechen wir über eure Telco-APIs.

In einer Demo zeigen wir, wie Katalog, Versionierung und Partnerportale mit TMF-Specs zusammenspielen.