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.
// Die Herausforderung
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.
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.
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.
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
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.
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.
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.
// Sicherheit & Betrieb
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.
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.
Wer wann welche Spec geändert hat, steht im Audit-Log. Das gibt internen Reviews und externen Prüfungen eine nachvollziehbare Grundlage.
Im Enterprise-Plan läuft die Plattform auf Wunsch auch in eurer eigenen Infrastruktur.
Die Cloud-Variante läuft in EU-Rechenzentren in Frankfurt, die Daten bleiben in der EU.
// API-Landschaft
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.
Produktangebote, Preise und Kategorien, die CRM, Shop und Partnerkanäle gemeinsam nutzen.
Bestellungen von Endkunden und Partnern mit Positionen, Status und Stornierung.
Prüft vor der Bestellung, ob ein Dienst an einer Adresse oder einem Anschluss verfügbar ist.
Technische Aufträge an das Netz, etwa die Aktivierung oder Änderung eines Dienstes.
Meldet, ob und wann die SIM-Karte zu einer Rufnummer zuletzt getauscht wurde, etwa zur Betrugsprävention.
Fordert für eine Sitzung eine bestimmte Netzqualität an und fragt ihren Status ab.
// Architektur
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.
# .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
Noch Fragen? Unser Team hilft gerne weiter.
Vertrieb kontaktierenIn einer Demo zeigen wir, wie Katalog, Versionierung und Partnerportale mit TMF-Specs zusammenspielen.