[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Télécharger un DCE

L'opération REST dce.download de Prescriptio sert à obtenir un téléchargement autorisé de DCE.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/dce.download \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"marche_id":"fixture-dce-001"}'
```

**Corps JSON**

```json
{
  "marche_id": "fixture-dce-001"
}
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": null,
  "content_type": "<texte>",
  "count": 0,
  "doc_type": "<texte>",
  "download_url": "<texte>",
  "expires_in": 0,
  "fichiers": [
    {
      "filename": "<texte>",
      "pages_estimees": 0,
      "parties": 0
    }
  ],
  "fields": {},
  "filename": "<texte>",
  "hint": "<texte>",
  "marche_id": "<texte>",
  "ok": null,
  "page": 0,
  "pages_total": 0,
  "query": "<texte>",
  "results": [
    {
      "acheteur": "<texte>",
      "doc_type": "<texte>",
      "extrait": "<texte>",
      "filename": "<texte>",
      "lieu": "<texte>",
      "marche_id": "<texte>",
      "titre": "<texte>"
    }
  ],
  "texte": "<texte>",
  "titre": "<texte>"
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `filename` | texte | — | Nom exact d'une pièce a telecharger (facultatif). Omis, ou pièce non stockee isolement : l'archive complete du dossier est renvoyee. |
| `marche_id` | texte | oui | Identifiant du dossier : UUID de marché OU annonce_id betterplace (ex "2833189"). |

## Quand l'utiliser

Un lien signé est temporaire, ne constitue pas une citation durable et ne doit pas être journalisé.

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/dce.download` |
| Contrat | 3.0.0 |
| Portée OAuth | `mcp:read` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Outil MCP | [`marches_dce_lien_obtenir`](https://prescriptio.fr/docs/api/marches_dce_lien_obtenir) : même traitement |

## Erreurs et quotas

Cet outil consomme **en plus une unité de dossier** : un dossier vaut une unité pour la journée, quel que soit le nombre de pièces lues ou téléchargées dedans. Le compteur de dossiers repart à minuit, heure de Paris ; les deux compteurs d'appels, eux, glissent sur leur fenêtre.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `dce.download`.

- [Les dossiers de consultation (DCE)](https://prescriptio.fr/docs/donnees/dce) : Documentation, Les données
- [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules
- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations

## Voir aussi

- [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse
- [marches_dce_lien_obtenir](https://prescriptio.fr/docs/api/marches_dce_lien_obtenir) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations