API › Problèmes

Lire un problème

Un problème avec sa gravité, ce que Rustine a observé et l'endroit où il l'a vu. Le correctif se demande à part, avec Débloquer le correctif.

GEThttps://api.rustine.io/v1/issues/{issue_id}

Permission OAuth : scans:read · une clé d'API les a toutes

Ouvrir dans Claude Ouvrir dans ChatGPT

Paramètres de chemin

issue_idstringobligatoire
Le problème.

Réponse

idstring
L'identifiant du problème ; il le garde d'un scan à l'autre.
objectstring
Le type d'objet, toujours le même pour une route donnée.
project_idstring
Le projet du problème.
target_idstring
Le site ou le dépôt où il a été trouvé.
addressstring
Le nom d'hôte du site ou propriétaire/dépôt.
control_idstring
Le contrôle qui l'a trouvé (identifiant stable).
familystring
La famille du contrôle : base de données, secrets, fichiers exposés…
databasesecretsexposedFilespersonalDatavulnerableVersionsconfigurationcomplianceservercode
severitystring
La gravité, de critical à info.
criticalhighmediumlowinfo
confidencestring
À quel point Rustine est sûr : confirmed (vu), likely (très probable), estimated (déduit, par exemple d'une version).
confirmedlikelyestimated
statusstring
open ; fixed (un scan ou une revérification ne le trouve plus) ; false_positive (sorti du score) ; accepted_risk (reste dans le score).
openfixedfalse_positiveaccepted_risk
titlestring
Le problème en une ligne, dans la langue du propriétaire de la clé.
explanationstring
Le risque en mots simples, dans la langue du propriétaire de la clé.
detailstring
Le détail technique, dans la langue du propriétaire de la clé.
locationstring
Où : un chemin, une table, ou fichier:ligne@commit dans un dépôt.
filestring | null
Problème de dépôt : le fichier.
lineinteger | null
Problème de dépôt : la ligne.
commitstring | null
Problème de dépôt : le commit analysé.
evidencestring
Ce que le contrôle a observé, secrets masqués.
fix_unlockedboolean
Vrai si son correctif est débloqué : le relire ne coûte rien.
status_reasonstring | null
Pourquoi il a été marqué faux positif ou risque accepté.
marked_bystring | null
Qui l'a marqué : un agent, le nom d'une clé d'API, ou app.
first_seen_atstring
Le premier scan qui l'a trouvé.
last_seen_atstring
Le dernier scan qui l'a trouvé.
fixed_atstring | null
Quand il a été trouvé corrigé.

Erreurs

Code	error.code	Ce qui se passe
401	authentication_required	Aucune clé dans la requête. Passe-la dans l'en-tête `Authorization: Bearer rst_…`, jamais dans l'adresse.
401	invalid_api_key	La clé ou le jeton OAuth est faux, révoqué ou expiré. Vérifie qu'il est copié en entier, ou crée une nouvelle clé.
402	api_plan_required	L'espace est sur l'offre Gratuite. L'API vient avec Pro, ou à l'essai 14 jours sur Solo.
402	api_trial_ended	L'essai de 14 jours de Solo est terminé. Passe à Pro : tes clés remarchent aussitôt.
403	scope_missing	Le jeton OAuth n'a pas la permission que demande cette route (indiquée sur sa page). Reconnecte l'agent pour l'accorder. Une clé d'API a toutes les permissions.
404	resource_not_found	Rien avec cet identifiant dans l'espace de la clé. Un objet d'un autre espace répond pareil : son existence n'est jamais révélée.
429	rate_limited	Trop de requêtes pour cette clé (120 par minute). Attends `Retry-After` secondes.
500	internal_error	Une erreur de notre côté, signalée automatiquement. Réessaie plus tard ; donne le `Request-Id` au support si elle revient.
503	service_unavailable	Rustine est indisponible un instant. Réessaie avec la même `Idempotency-Key`.