PharmAssistant APIv1.0.0

Accès programmatique à l'assistant pharmaceutique PharmAssistant : chaque question suit le même moteur deux étapes que le chat (routage vers les bases documentaires spécialisées, exécution des outils, rédaction sourcée) et revient en JSON structuré, non streamé, sans aucun marqueur d'IA interne. Les clés du contrat sont en anglais, les contenus en français.

Base : https://api.pharmassistant.fr · Spécification machine : openapi.json

Authentification

Démarrage rapide

# Une question, une réponse structurée
curl "https://api.pharmassistant.fr/v1/ask" \
  -H "X-API-Key: pa_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"question": "Amoxicilline et allaitement ?"}'

# Ou en un seul GET, pour un test immédiat sans corps JSON
curl "https://api.pharmassistant.fr/v1/ask?q=amoxicilline+et+allaitement" \
  -H "X-API-Key: pa_votre_cle"

# Conversation côté serveur : "store": true à l'ouverture…
curl "https://api.pharmassistant.fr/v1/ask" \
  -H "X-API-Key: pa_votre_cle" -H "Content-Type: application/json" \
  -d '{"question": "Amoxicilline et allaitement ?", "store": true}'
# → la réponse porte "conversation_id": "conv_…"

# …puis conversation_id à chaque tour suivant (historique rechargé par le serveur)
curl "https://api.pharmassistant.fr/v1/ask" \
  -H "X-API-Key: pa_votre_cle" -H "Content-Type: application/json" \
  -d '{"question": "Et pendant la grossesse ?", "conversation_id": "conv_…"}'

curl -O https://api.pharmassistant.fr/clients/pharmassistant.py

from pharmassistant import PharmAssistant

client = PharmAssistant("pa_votre_cle")   # ou variable PHARMASSISTANT_API_KEY

# Une question, une réponse structurée
reponse = client.ask("Amoxicilline et allaitement ?", store=True)
print(reponse["answer"])            # markdown propre
print(reponse["patient_advice"])    # discours prêt pour le patient

# Poursuivre la conversation : le serveur porte l'historique
suite = client.ask("Et pendant la grossesse ?",
                   conversation_id=reponse["conversation_id"])
print(suite["answer"])

curl -O https://api.pharmassistant.fr/clients/pharmassistant.ts

import { PharmAssistant } from "./pharmassistant";

const client = new PharmAssistant("pa_votre_cle");  // ou variable PHARMASSISTANT_API_KEY

// Une question, une réponse structurée (types complets du contrat)
const reponse = await client.ask("Amoxicilline et allaitement ?", { store: true });
console.log(reponse.answer);           // markdown propre
console.log(reponse.patient_advice);   // discours prêt pour le patient

// Poursuivre la conversation : le serveur porte l'historique
const suite = await client.ask("Et pendant la grossesse ?",
  { conversationId: reponse.conversation_id! });
console.log(suite.answer);

curl -O https://api.pharmassistant.fr/clients/PharmAssistant.java

PharmAssistant client = new PharmAssistant("pa_votre_cle");

// Une question, une réponse structurée
Map<String, Object> reponse = client.ask("Amoxicilline et allaitement ?",
    new PharmAssistant.AskOptions().store(true));
System.out.println(reponse.get("answer"));          // markdown propre
System.out.println(reponse.get("patient_advice"));  // discours prêt pour le patient

// Poursuivre la conversation : le serveur porte l'historique
Map<String, Object> suite = client.ask("Et pendant la grossesse ?",
    new PharmAssistant.AskOptions().conversationId((String) reponse.get("conversation_id")));
System.out.println(suite.get("answer"));

Exemple de réponse (abrégée) :

{
  "id": "req_9f2c4a1b6d8e3f07",
  "object": "pharmassistant.answer",
  "created_at": "2026-07-23T14:05:12+00:00",
  "status": "ok",
  "mode": "standard",
  "question": "Amoxicilline et allaitement ?",
  "title": "Amoxicilline pendant l'allaitement",
  "answer": "L'amoxicilline est compatible avec l'allaitement…",
  "key_points": [
    {"polarity": "positive", "text": "Compatible avec l'allaitement (passage lacté très faible)."},
    {"polarity": "negative", "text": "Surveiller diarrhée ou éruption chez le nourrisson."}
  ],
  "patient_advice": "Vous pouvez poursuivre l'allaitement normalement…",
  "associated_sale": null,
  "clarification": null,
  "suggestions": ["Conduite à tenir en cas de candidose sous antibiotique ?"],
  "tools_used": ["lecrat_search", "lactmed_search"],
  "sources": {
    "lecrat_search": [{"title": "CRAT : amoxicilline", "url": "https://www.lecrat.fr/…"}],
    "lactmed_search": [{"title": "LactMed : Amoxicillin", "url": "https://www.ncbi.nlm.nih.gov/…"}]
  },
  "conversation_id": "conv_9a8b7c6d5e4f3a2b",
  "usage": {"elapsed_ms": 6480, "daily_requests_used": 12, "daily_requests_limit": 200}
}

Conversations

Streaming (SSE)

"stream": true (POST seulement) fait passer la réponse en Server-Sent Events (text/event-stream) : la réponse s'affiche au fil de la génération, et l'événement final done porte le même objet complet que la réponse non streamée (champs structurés, sources, usage).

curl -N "https://api.pharmassistant.fr/v1/ask" \
  -H "X-API-Key: pa_votre_cle" -H "Content-Type: application/json" \
  -d '{"question": "Amoxicilline et allaitement ?", "stream": true}'

event: start
data: {"id": "req_9f2c4a1b6d8e3f07", "mode": "standard", "conversation_id": null, …}

event: status
data: {"state": "tools_running", "tools": ["lecrat_search", "lactmed_search"]}

event: chunk
data: {"text": "L'amoxicilline est compatible avec l'allaitement…"}

event: done
data: { …le même objet complet que la réponse non streamée… }

Avec les clients officiels (Python, TypeScript, Java) :

for event, data in client.ask_stream("Amoxicilline et allaitement ?"):
    if event == "chunk":
        print(data["text"], end="", flush=True)
    elif event == "done":
        reponse = data   # le même JSON complet que client.ask()

for await (const { event, data } of client.askStream("Amoxicilline et allaitement ?")) {
  if (event === "chunk") process.stdout.write(data.text);
  else if (event === "done") reponse = data;   // le même JSON complet que client.ask()
}

Map<String, Object> reponse = client.askStream("Amoxicilline et allaitement ?",
    new PharmAssistant.AskOptions(),
    (event, data) -> { if (event.equals("chunk")) System.out.print(data.get("text")); });

Le streaming se combine librement avec les conversations (store / conversation_id) et le mode detailed.

Modes de réponse

• standard : la réponse rapide du comptoir, sourcée et structurée (titre, réponse markdown, points clés à polarité, discours patient, vente associée, pistes d'approfondissement, sources complètes par base).
• detailed : le moteur « Réponse détaillée » (analyse exhaustive, entité par entité), soumis à la portée ask:detailed de la clé et à son éventuel sous-plafond journalier.

Quotas et en-têtes

La facturation compte des requêtes, pas des tokens. Chaque réponse porte des en-têtes de pilotage :

GET /v1/me renvoie l'état complet de la clé : plafonds, portées, consommation du jour et du mois.

Endpoints

Erreurs

Toutes les erreurs partagent la même enveloppe {"error": {"code", "message", "details"}} avec un code machine stable. Une requête refusée ou échouée (429, 500, 502) n'est jamais décomptée.

Schémas

Objets JSON du contrat, tels que renvoyés ou attendus par l'API.