Introduction au projet CAMARA

Mise à jour importante : nous avons modifié la façon dont nos API utilisent la norme CAMARA. Curieux de savoir ce qu'il y a de nouveau ? Consultez notre dernier article "Comment Vonage utilise les API CAMARA pour améliorer l'expérience des développeurs"

Dans notre article précédent Annonce des API du réseau Vonagenous avons présenté l'idée que les nouvelles API ont été construites selon la norme norme CAMARA. Dans cet article, nous allons approfondir le projet CAMARA pour comprendre ses implications et ce qu'il signifie pour l'industrie des télécommunications.

Qu'est-ce que le CAMARA ?

Imaginez : les géants des télécommunications et de la technologie se réunissent comme les Avengers pour établir une nouvelle norme visant à harmoniser et à exposer les nouvelles capacités du réseau afin de créer une expérience transparente pour l'utilisateur. N'en parlons plus. Bienvenue au CAMARA !

CAMARA est un projet open-source au sein de la Fondation Linux qui héberge les normes API et développe et teste les API. Le projet collabore étroitement avec le GSMA Operator Platform Group pour aligner les exigences en matière d'API.

Le nom CAMARA provient du mot grec signifiant "toit arqué", symbolisant la collaboration ou l'alliance de plusieurs entités autour d'une même vision.

Comment cela fonctionne-t-il ?

Les membres (participants, coordinateurs, contributeurs, etc.) du projet CAMARA sont organisés en sous-projets et en groupes de travail. Bien que cela puisse sembler similaire, il y a quelques différences.

Sous-projets

Un sous-projet est l'endroit où les sujets liés à chaque API sont discutés, y compris la façon de documenter et de décrire l'API ou de la développer et de la tester. Voici quelques exemples de sous-projets SIM Swap, Statut de l'appareilou Vérification du numéro.

Les membres de chaque sous-projet se rencontrent virtuellement de temps en temps et organisent leur travail autour d'un dépôt GitHub et d'une liste de diffusion. Tous les dépôts contiennent la même structure, ce qui facilite la recherche d'informations :

• Le dossier documentation/MeetingMinutes contient tous les procès-verbaux des réunions précédentes, au cours desquelles sont prises les décisions concernant le comportement de l'API.

• Le fichier code/API_definitions contient la spécification OpenAPI de l'API au format YAML.

Groupes de travail

Les groupes de travail traitent généralement de sujets communs à tous les sous-projets. Voici quelques exemples de groupes de travail API Backlogqui gère le cycle de vie des propositions d'API, le groupe Marketing, chargé de la promotion des API, ou le groupe Commonalities, où sont discutés des sujets communs à toutes les API (par exemple, l'autorisation, la documentation ou les lignes directrices).

Tout comme les sous-projets, les membres des groupes de travail utilisent un dépôt dépôt GitHub et une liste de diffusion pour coordonner leurs activités.

Si vous êtes curieux de connaître la structure du projet et les rôles de ses participants, consultez la rubrique Structure du projet et rôles page de documentation.

Cycle de vie de l'API

L'une des activités les plus intéressantes du projet consiste à maintenir le cycle de vie des API.

Tout commence par l API onboardingoù les entreprises peuvent soumettre une nouvelle proposition d'API en donnant une description détaillée de l'API (ce qu'elle fait avec quelques exemples), ainsi que sa viabilité technique et commerciale.

Le groupe de travail sur le backlog de l'API évaluera la proposition et, s'il l'approuve, il approuvera l'envoi de la proposition au comité de pilotage pour approbation finale. Si tout se passe bien, la proposition d'API sera transformée en un sous-projet réel, qui commencera à recevoir des contributions et des idées à l'aide des mécanismes décrits ci-dessus.

Lorsque la spécification de l'API sera suffisamment stable, la mise en œuvre sera déployée et testée dans un ou plusieurs réseaux d'opérateurs. Le déploiement pourra être utilisé dans des environnements de production si les tests s'avèrent concluants.

Conclusion

Le projet CAMARA pose un jalon important dans le secteur des télécommunications en termes de coordination et de coopération. La structure ouverte du projet facilite le suivi et la compréhension des décisions prises pour chaque API.

Les ressources et la documentation déjà produites par les membres du projet sont nombreuses. Ne manquez pas d'explorer leur GitHub et leur Wiki.

Si vous avez des questions ou des commentaires, n'hésitez pas à nous en faire part dans notre canal Slack de la communauté et suivez-nous sur X.