API › Problèmes

Lister les problèmes

Les problèmes d'un projet, du plus grave au moins grave, avec leur niveau de confiance. Filtre par statut, gravité ou site.

GEThttps://api.rustine.io/v1/projects/{project_id}/issues

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

Ouvrir dans Claude Ouvrir dans ChatGPT

Les problèmes d'un site pas encore prouvé restent masqués : le site donne seulement leur nombre (targets[].hidden_issues dans Lire un projet), jusqu'à ce que tu prouves qu'il est à toi.

Paramètres de chemin

project_idstringobligatoire
Le projet.

Paramètres de requête

limitintegeroptionnel
Combien d'éléments par page, de 1 à 100 (20 par défaut).
starting_afterstringoptionnel
Le curseur : l'identifiant du dernier élément de la page précédente.
statusstringoptionnel
Seulement les problèmes dans ce statut.
openfixedfalse_positiveaccepted_risk
severitystringoptionnel
Seulement les problèmes de cette gravité.
criticalhighmediumlowinfo
target_idstringoptionnel
Seulement les problèmes de ce site ou de ce dépôt.

Réponse

objectstring
Le type d'objet, toujours le même pour une route donnée.
dataarray of object
Les éléments de la page.
- 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é.
has_moreboolean
Vrai s'il reste des éléments après cette page : rappelle la route avec starting_after.

Erreurs

Code	error.code	Ce qui se passe
400	parameter_invalid	Un paramètre manque ou n'est pas valable ; `param` le nomme.
400	cursor_invalid	`starting_after` n'est l'identifiant d'aucun élément de cette liste.
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`.