Files
mabibli/MaBibli.Api/Endpoints/IsbnEndpoints.cs
T
mathieuandClaude Opus 5 f8f30dbcf7 Phase 2 : service de lookup ISBN en cascade BnF puis OpenLibrary
Recuperation des metadonnees d'un livre a partir de son ISBN, cote serveur
uniquement (aucune interface, aucune persistance).

Cascade : BnF en ISBN-13, puis BnF en ISBN-10 converti, puis OpenLibrary.
La conversion 13 -> 10 est indispensable et non optionnelle : la BnF indexe
l'ISBN tel qu'imprime, les ouvrages d'avant 2007 ne portent qu'un ISBN-10 et
sont introuvables par l'EAN-13 que lit le scanner.

Toutes les notices trouvees sont remontees (jusqu'a 5) : un meme ISBN peut
correspondre a plusieurs reeditions, le choix revient a l'utilisateur.

Le double appel /isbn puis /authors d'OpenLibrary est bien fait, avec repli
sur l'oeuvre quand l'edition ne porte aucun auteur : c'est le bug de BookLogr
(titre rempli, auteur vide) qu'il ne faut pas reproduire.

La couverture vient toujours d'OpenLibrary, avec ?default=false pour obtenir
un 404 plutot qu'une image placeholder.

87 tests xUnit, sur fixtures enregistrees : aucune dependance au reseau.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 22:22:47 +02:00

38 lines
1.4 KiB
C#

using MaBibli.Api.Services.Isbn;
using MaBibli.Shared.Dtos;
namespace MaBibli.Api.Endpoints;
public static class IsbnEndpoints
{
/// <summary>
/// Expose le lookup ISBN. Aucune écriture en base : cet endpoint pré-remplit un formulaire,
/// il n'enregistre rien.
/// </summary>
public static IEndpointRouteBuilder MapIsbnEndpoints(this IEndpointRouteBuilder routes)
{
var groupe = routes.MapGroup("/api/isbn").WithTags("ISBN");
groupe.MapGet("/{isbn}", async (
string isbn,
IIsbnLookupService service,
CancellationToken ct) =>
{
var resultat = await service.RechercherAsync(isbn, ct);
return resultat is null
? Results.BadRequest(new { erreur = $"« {isbn} » n'est pas un ISBN valide." })
: Results.Ok(resultat);
})
.WithName("RechercherIsbn")
.WithSummary("Cherche les notices correspondant à un ISBN (cascade BnF → OpenLibrary).")
.WithDescription(
"Renvoie TOUS les candidats trouvés (jusqu'à 5) : un même ISBN peut correspondre à "
+ "plusieurs rééditions. Le choix revient à l'utilisateur.")
.Produces<ResultatLookupIsbn>()
.Produces(StatusCodes.Status400BadRequest);
return routes;
}
}