HTTP Status Code
Code de statut HTTP
Un code d'état HTTP est un nombre à trois chiffres dans une réponse. Il indique le résultat standard de la requête et à quel groupe de résultats il appartient.
Un autre exemple
Une API d'importation retourne 202 et une URL de statut pendant que le travail continue. Elle retourne 201 avec `Location` après une création immédiate. Elle retourne 409 pour un conflit de version et 422 pour des champs CSV avec une signification invalide. Un corps de problème JSON ajoute des détails utiles sans changer la signification du code.
Parties principales
- 01Classe de statut
- 02Code enregistré
- 03Métadonnées et corps de la réponse
Utilisez-le lorsque
Retournez le code enregistré le plus exact correspondant au résultat. Ajoutez des en-têtes utiles et un corps d'erreur stable si nécessaire.
Ne l'utilisez pas lorsque
Ne retournez pas 200 pour chaque échec métier. Évitez également les erreurs trop spécifiques qui révéleraient des détails d'autorisation secrets.
Nom utilisé dans le code
1xx informational, 2xx success, 3xx redirection, 4xx client, 5xx server Avant d'expédier
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with Code de statut HTTP (HTTP Status Code). User context: Une API d'importation retourne 202 et une URL de statut pendant que le travail continue. Elle retourne 201 avec `Location` après une création immédiate. Elle retourne 409 pour un conflit de version et 422 pour des champs CSV avec une signification invalide. Un corps de problème JSON ajoute des détails utiles sans changer la signification du code. Technical concept or control: Code de statut HTTP (HTTP Status Code). Why it fits: Retournez le code enregistré le plus exact correspondant au résultat. Ajoutez des en-têtes utiles et un corps d'erreur stable si nécessaire. Do not use it when: Ne retournez pas 200 pour chaque échec métier. Évitez également les erreurs trop spécifiques qui révéleraient des détails d'autorisation secrets. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): La norme couvre uniquement le champ d'application énuméré. Elle ne choisit ni le style visuel, ni la décision de produit, ni l'exemple de Vibulary. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Vérifiez cette demande
Review how Code de statut HTTP (HTTP Status Code) is used now. Definition: Un code d'état HTTP est un nombre à trois chiffres dans une réponse. Il indique le résultat standard de la requête et à quel groupe de résultats il appartient. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.