Toutes les ressources premium et membres pour 8,99 €/mois, en abonnement sans engagement. Voir les offres

PalateKit

Se connecter
Menu

Demander une ressource

Décrivez en une phrase la ressource qui vous manque. Nous vous écrirons quand elle sera publiée.

0 / 280

Une page, une vidéo ou une image en ligne.

Débloquer PalateKit

Tout débloquer

Offre

Le paiement vaut acceptation de nos conditions générales de vente.

Paiement sécurisé par Stripe. Reçus et factures envoyés par e-mail.

Content de vous revoir

Connectez-vous pour installer, télécharger ou sauvegarder cette ressource. Un compte gratuit suffit pour les ressources gratuites.

Conception des erreurs d'API : codes, enveloppe et messages v1.0.0

Utilisez cette ressource pour concevoir les erreurs d'une API publique pour qu'un intégrateur corrige seul son problème

Nouveau

  • 338 téléchargements
  • 111 mentions J'aime
  • 114 sauvegardes

Gratuit

Installer avec la CLI

Dans un terminal, depuis le dossier voulu :

npx --yes palatekit@latest install api-error-responses-design

Sans option, la skill va dans ~/.agents/skills/ ; ajoutez --agent claude-code (ou codex, cursor…) pour viser un agent.

Première fois : connectez la CLI avec

npx --yes palatekit@latest login

L'agent audite les réponses d'erreur, choisit une taxonomie de codes lisibles par machine, adopte l'enveloppe RFC 9457 et réécrit les messages pour qu'ils indiquent la cause et la solution. Il prévoit aussi les signaux de réessai et la documentation par endpoint. Vous obtenez une spécification d'erreurs cohérente et documentée.

Choisie surtout par

Mise à jour le 2 novembre 2026

Carte de la skill « Conception des erreurs d'API : codes, enveloppe et messages »

Caractéristiques

Fonctionne dans
Guides d'installation
Génère avec
Le modèle de votre agent
Licence
MIT

Ressources similaires

Tout voir

Ce que vous obtenez

  • SKILL.md : audit de la surface d'erreurs et méthode en six étapes
  • references/rfc9457-payload-examples.md : exemples de réponses au format problem details
  • references/message-rewrite-examples.md : exemples de réécriture de messages

Pour qui

  • Vos intégrateurs ouvrent des tickets à cause d'erreurs 400 peu claires
  • Vous voulez normaliser les codes d'erreur avant une version publique

Pas pour qui

    Étiquettes

    • api
    • erreurs
    • rfc 9457
    • documentation

    À propos

    Vous dites

    « Reprends les erreurs de notre API de paiement : codes stables, messages actionnables et conseil de nouvel essai. »

    Carte de la skill « Conception des erreurs d'API : codes, enveloppe et messages »

    Skill publiée par samber sous licence MIT. Fichiers livrés dans leur version d'origine, en anglais.

    Voir plus

    Comment l'utiliser

    1. Installez la skill dans le dossier de skills de votre agent
    2. Demandez à votre agent de concevoir les erreurs d'une API publique pour qu'un intégrateur corrige seul son problème
    3. Relisez et ajustez le résultat

    Aperçu du contenu

    Fichiers

    • evals/evals.json26,6 Ko
    • LICENSE1,1 Ko
    • NOTICE-PALATEKIT.md0,5 Ko
    • references/error-documentation-examples.md3,9 Ko
    • references/message-rewrite-examples.md3,6 Ko
    • references/rfc9457-payload-examples.md4,8 Ko
    • references/taxonomy-catalog-examples.md5,6 Ko
    • SKILL.md18,2 Ko

    Origine et licence

    Référencée sans modification

    Auteur
    samber
    Source
    github.com/samber/developer-platform-skills/tree/e262cfeabab5f38710334540f8ca5d67b24753c2/skills/api-error-design
    Licence
    MIT

    Notice

    « api-error-design » (samber, MIT) livré dans sa version d'origine : fiche en français et en anglais par PalateKit.

    Avis des utilisateurs

    –

    Aucune note pour l'instant

    Chargement des avis…

    Supprimer votre avis ?

    Votre note et votre commentaire seront retirés de la fiche.