Référence

Extraction de contenu

Extraction asynchrone du texte d’une page web (HTML statique, rendu JavaScript si activé sur l’instance). Le contenu n’est pas indexé dans la base de connaissances RAG — usage ponctuel pour enrichir vos propres systèmes. Scope opt-in `content:extract` ; scraping et assistant IA doivent être activés sur l’instance.

Base URL : https://sandbox-api.reachflow.me/api/v1

Modèle de données

Champs

Nom	Type	Description
jobId	string (uuid)	Identifiant du job d’extraction.
status	enum	PENDING (en cours), READY (texte disponible), FAILED (erreur).
url	string (url)	URL source de l’extraction.
title	string	Titre de la page (si détecté).
text	string	Texte extrait (max 100 000 car.).
qualityScore	number	Score de qualité 0–1 (indicatif).
qualityFlags	array	Signaux de qualité (ex. spa_shell, low_content).
renderedWithJs	boolean	true si un rendu JavaScript a été utilisé.
proposedChunkCount	integer	Nombre de chunks estimés (informatif).
errorReason	string	Motif d’échec si status FAILED.

POST/api/v1/content/extract

Lancer une extraction

Soumet une URL et retourne un jobId. Interrogez GET /content/extract/{jobId} jusqu’à status READY ou FAILED.

Scope requis : content:extract

Attributs requis

Nom	Type	Description
url*	string (url)	Page à extraire (max 2048 car.).

Requête

curl --request POST \
  "https://sandbox-api.reachflow.me/api/v1/content/extract" \
  --header "X-API-Key: rfl_live_VOTRE_CLE" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json"
  --data '{ "url": "https://example.com/article" }'

Réponse

JSON

{
  "jobId": "e1f2a3b4-c5d6-4789-a012-3456789abcde",
  "status": "PENDING"
}

Limite : 10 extractions / minute / compte (hors quota HTTP plan).

Respectez robots.txt et les conditions d’utilisation des sites cibles.

GET/api/v1/content/extract/{jobId}

Résultat d’une extraction

Consulte le statut et le texte extrait d’un job lancé via POST /content/extract.

Scope requis : content:extract

Paramètres

Nom	Type	Emplacement	Description
jobId*	string (uuid)	path	Identifiant retourné par POST /content/extract.

Requête

curl --request GET \
  --get "https://sandbox-api.reachflow.me/api/v1/content/extract/{jobId}" \
  --header "X-API-Key: rfl_live_VOTRE_CLE" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json"

Réponse

JSON

{
  "jobId": "e1f2a3b4-c5d6-4789-a012-3456789abcde",
  "status": "READY",
  "url": "https://example.com/article",
  "title": "Titre de la page",
  "text": "Contenu principal extrait de la page…",
  "qualityScore": 0.92,
  "qualityFlags": [],
  "renderedWithJs": false,
  "proposedChunkCount": 4
}