Compétences allra-api-design

📦

allra-api-design

Name: allra-api-design
Author: Allra-Fintech

Révision du contenu r2 Sûr ⚙️ Commandes externes

Concevoir des API REST Spring pour Allra

Les équipes backend perdent souvent en cohérence lorsqu'elles ajoutent des API Spring et des DTO. Cette compétence applique les conventions Allra pour l'organisation des packages, le nommage REST, les records DTO, la validation et les réponses.

Prend en charge: Claude Codex Code(CC)

🥉 78 Bronze

Maintain this Skill? Claim it 🥉 78 Bronze

Installer avec mon Agent

Copiez cette demande dans votre Agent. Elle contient la page Skill de référence et le manifeste.

Demande d’agent

Review the Skillstore skill "allra-api-design" from https://skillstore.io/skills/allra-fintech-allra-api-design.md and its manifest at https://skillstore.io/api/skills/allra-fintech-allra-api-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Votre Agent doit toujours présenter son plan et demander toute confirmation exigée par la politique de sécurité.

Ressources lisibles par les agents

Utilisez ces liens lorsqu’un Agent IA, un crawler ou un script a besoin d’un contexte propre au lieu de lire toute la page.

Détail Markdown GET /skills/allra-fintech-allra-api-design.md manifest signé GET /api/skills/allra-fintech-allra-api-design/manifest lockfile signé GET /api/skills/allra-fintech-allra-api-design/lockfile

Tester

Utilisation de « allra-api-design ». Créer une API de création de produit pour un service backend Allra.

Résultat attendu:

Le résultat nomme le package du domaine produit et sépare les couches API, DTO, entité, repository et service.
Il propose CreateProductRequest et ProductResponse comme noms de DTO publics.
Il recommande la validation obligatoire pour les champs de nom et de prix du produit.

Utilisation de « allra-api-design ». Examiner la structure de mon API utilisateur selon les standards Allra.

Résultat attendu:

La revue signale les noms de packages qui ne séparent pas les responsabilités de contrôleur, DTO, repository et service.
Elle identifie les DTO qui devraient utiliser les suffixes Request, Response ou Dto.
Elle vérifie si les DTO de requête incluent des règles de validation.

Utilisation de « allra-api-design ». Planifier les DTO internes pour les résultats de requêtes produit et les événements.

Résultat attendu:

Le plan distingue les DTO destinés aux clients des objets de transfert internes.
Il recommande les suffixes Dto pour les objets internes de requête et d'événement.
Il indique où les DTO de projection QueryDSL peuvent être appropriés.

Audit de sécurité

Sûr

v9 • 23/07/2026 Ouvrir le rapport versionné

All 31 static findings are false positives caused by Markdown backticks, fenced examples, and ordinary Java request parameters. The skill is a documentation-only API design guide with no command execution, system reconnaissance, or prompt injection behavior.

Fichiers analysés

269

Lignes analysées

Éléments à examiner

Faux positifs ignorés

Le dernier audit statique et sémantique terminé n’a détecté aucun constat de sécurité confirmé. Cela ne prouve pas que le skill est sans effets secondaires.

Audité par: codex Voir l’historique des audits →

Partager et citer ce rapport

Partagez le rapport d’évaluation versionné, le badge neutre, la carte intégrable et les citations. Skillstore présente les preuves sans décider si ce Skill est sûr.

Ouvrir le rapport versionné

Copier le lien du rapport

https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Badge Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg)](https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge)

Badge HTML

<a href="https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Carte intégrable

<iframe src="https://skillstore.io/embed/skills/allra-fintech-allra-api-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citations académiques (APA · BibTeX · CFF)

Citation APA

Allra-Fintech. (2026). allra-api-design security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9

Citation BibTeX

@techreport{allra-fintech-allra-fintech-allra-api-design-2026,
  author = {Allra-Fintech},
  title = {allra-api-design security audit report (audit version 9)},
  institution = {Skillstore},
  year = {2026},
  number = {9},
  url = {https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "allra-api-design security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
  - name: "Allra-Fintech"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9"
identifiers:
  - type: other
    value: "skillstore:allra-fintech-allra-api-design:audit:9"
    description: "Skillstore immutable audit report identifier"

Score Skillstore

Pourquoi ce score Niveau de confiance des preuves: Élevé

Architecture

Maintenabilité

Contenu

Communauté

Conformité aux spécifications

Ce que vous pouvez créer

Créer une nouvelle API de domaine

Générer un plan de packages cohérent, des noms de DTO, des routes de contrôleur et une checklist de validation pour un nouveau domaine backend.

Revoir la cohérence d'une API

Comparer les conceptions existantes de contrôleurs et de DTO aux conventions Allra avant la fusion d'une pull request.

Guider le travail backend assisté par IA

Maintenir Claude, Codex ou Claude Code alignés avec les standards backend Allra pendant les tâches d'implémentation.

Essayez ces prompts

Créer un plan de DTO

Concevoir les DTO de requête et de réponse pour une nouvelle API d'inscription utilisateur en utilisant les conventions Allra. Inclure des recommandations de validation des champs.

Concevoir un endpoint REST

Concevoir un endpoint REST Spring de style Allra pour créer des produits. Inclure le nommage des routes, l'emplacement dans les packages, les noms de DTO et les recommandations de réponse.

Refactoriser la structure des packages

Examiner cette structure de module backend et suggérer des changements qui l'alignent sur les règles de packages par domaine d'Allra et les responsabilités des couches.

Auditer la conception d'API avant fusion

Auditer cette conception d'API Spring par rapport aux standards Allra. Vérifier l'organisation des packages, le nommage REST, les suffixes DTO, l'utilisation de records, la validation et la cohérence des réponses.

Bonnes pratiques

Fournir le domaine cible, l'objectif de l'endpoint et les noms de packages existants avant de demander une conception.
Demander des règles de validation chaque fois qu'un DTO de requête accepte une entrée client.
Examiner les conceptions générées par rapport aux politiques propres au projet pour le versionnement des API et les réponses.

Éviter

Ne pas mélanger les classes de contrôleur, service, repository et entité dans un seul package.
Ne pas utiliser le suffixe Dto pour les objets publics de requête ou de réponse.
Ne pas copier des formes de réponses d'exemple sans vérifier le standard du projet.

Foire aux questions

Qu'est-ce que cette compétence aide à concevoir ?

Elle aide à concevoir des API REST Spring, des noms de DTO, des règles de validation, des formes de réponses et la structure de packages par domaine pour les backends Allra.

Génère-t-elle du code prêt pour la production ?

Elle fournit des conseils de conception et des exemples. Le code de production nécessite toujours le contexte du projet, des tests, l'autorisation et les détails de persistance.

Quel style Java privilégie-t-elle pour les DTO ?

Elle privilégie les records Java pour les objets simples de requête, de réponse et de transfert interne lorsque le projet les prend en charge.

Peut-elle être utilisée en dehors des projets Allra ?

Oui, mais les conventions sont propres à Allra. Les autres équipes devraient adapter les noms, les routes et les formats de réponse à leurs propres standards.

Couvre-t-elle la sécurité des API ?

Seules des recommandations de validation de base sont incluses. L'authentification, l'autorisation, les limites de débit et la gestion des données sensibles nécessitent une revue séparée.

Quels outils d'IA peuvent l'utiliser ?

Le rapport indique la prise en charge de Claude, Codex et Claude Code.

Détails du développeur

Auteur

Allra-Fintech

Licence

MIT

Révision Skillstore

Avis de version

L’auteur n’a déclaré aucune version.

Dépôt

https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/api-design

Réf

31bc7611b504c197d3e993aef7943461c871616f

Récence de maintenance

29/07/2026

Utilisation

10 téléchargements · 233 vues

Structure de fichiers

📄 SKILL.md

allra-api-design

Installer avec mon Agent

Ressources lisibles par les agents

Tester

Audit de sécurité

Facteurs de risque

Copier le lien du rapport

Badge Markdown

Badge HTML

Carte intégrable

Citation APA

Citation BibTeX

CITATION.cff

Score Skillstore

Ce que vous pouvez créer

Créer une nouvelle API de domaine

Revoir la cohérence d'une API

Guider le travail backend assisté par IA

Essayez ces prompts

Bonnes pratiques

Éviter

Foire aux questions

Détails du développeur