Extension Custom (Endpoint YFI)

Contenu
Changelog

L'extension directus-extension-you-find-it est le cœur logique du système. Elle expose un endpoint API unifié sous le préfixe /yfi.

Endpoints Principaux

Route	Description	Params
`/yfi/exportGolda`	Export au format Golda	`brand_id`, `is_csv_export`
`/yfi/exportCatalogue`	Export catalogue complet	`brand_id`, `is_csv_export`
`/yfi/getPricesByKtype/:ktype`	Prix de vente par KType	`ktype`
`/yfi/price`	Recherche précise de prix	`genart`, `is_kit`, `ktype`
`/yfi/e/k/:ktype`	Prix kit (Fullservice) depuis ktype échappement	`ktype`

[!NOTE] La route /yfi/price remplace progressivement le microservice externe api-kit-price pour une meilleure centralisation et performance.

Kit Echappement (`/e/k/:ktype`)

[!INFO] Cette route a été spécifiquement demandée pour l'intégration Fullservice.

Permet de récupérer le prix d'un kit d'échappement à partir du KType spécifié.

Méthode : GET /yfi/e/k/:ktype

Paramètre	Type	Description
`ktype`	`string`	Identifiant de type (KType) du véhicule

Supprimer un article (`article/delete`)

Permet de supprimer un ou plusieurs articles identifiés par leur référence et leur marque.

Méthode : POST /yfi/article/delete

Corps de la requête :

{
  "artNos": [
    "53341E"
  ],
  "brandNo": 6107
}

Champ	Type	Description
`artNos`	`string[]`	Liste des références articles à supprimer
`brandNo`	`number`	Identifiant de la marque (brand)

Validation des données

Toutes les routes utilisent Zod pour valider les paramètres de requête. Si une requête est mal formée, elle est automatiquement rejetée avec une erreur 400.

Intégration Oasis / TecDoc

L'extension utilise une classe utilitaire Oasis pour interroger les catalogues et les équivalences (cross-references). Elle permet de faire le pont entre les données Directus et les données externes TecDoc.

Développement de l'extension

Le code source se trouve dans src/endpoint/index.ts. Pour compiler les modifications :

pnpm run build
# Le résultat est envoyé dans le dossier /dist

Le conteneur Directus redémarre automatiquement le build si CHOKIDAR_USEPOLLING=true est activé en mode dev.

Version	Auteur	Date	Description
1.0	Eliott TAILLEPIED THOMINE	2026-03-27	Initial
1.1	AntiGravity	2026-04-02	Ajout de la route API /e/k/:ktype

Endpoints Principaux​

Kit Echappement (/e/k/:ktype)​

Supprimer un article (article/delete)​

Validation des données​

Intégration Oasis / TecDoc​

Développement de l'extension​