RPPS API PHP SDK

composer require qrcommunication/rppsapi

<?php

use QrCommunication\RppsApi\RppsClient;
use QrCommunication\RppsApi\RppsClientOptions;
use QrCommunication\RppsApi\Dto\RppsSearchCriteria;
use QrCommunication\RppsApi\Exception\RppsException;

$client = new RppsClient(new RppsClientOptions(
    fhirApiKey: $_ENV['FHIR_API_KEY'] ?? null,
));

// ── Profil complet par numéro RPPS ─────────────────────────────

try {
    $profil = $client->getByRpps('10005173140');

    echo $profil->identite->civiliteExercice->libelle . ' ';
    echo $profil->identite->prenomExercice . ' ' . $profil->identite->nomExercice . "\n";
    echo 'Profession : ' . $profil->profession->libelle . "\n";

    foreach ($profil->activites as $activite) {
        echo '  Structure : ' . $activite->structure->raisonSociale . "\n";
        echo '  Adresse   : ' . $activite->structure->adresse->libelleCommune . "\n";
    }

    foreach ($profil->diplomesEtAutorisations as $da) {
        if ($da->diplome) {
            echo '  Diplôme : ' . $da->diplome->libelle . "\n";
        }
    }

    foreach ($profil->savoirFaire as $sf) {
        echo '  Savoir-faire : ' . $sf->savoirFaire->libelle . "\n";
    }

    foreach ($profil->messageriesMssante as $mss) {
        echo '  MSSanté : ' . $mss->adresseBal . "\n";
    }

    // Statut des sources interrogées
    foreach ($profil->sources as $source) {
        $status = $source->success ? 'OK' : 'ERREUR';
        echo "  [{$status}] {$source->source->value} — {$source->durationMs}ms\n";
    }

} catch (RppsException $e) {
    echo 'Erreur RPPS : ' . $e->getMessage() . "\n";
}

// ── Recherche par critères ──────────────────────────────────────

$results = $client->search(new RppsSearchCriteria(
    nom: 'DUPONT',
    codePostal: '75',
));

echo "Total trouvé : {$results->total}\n";
echo "Durée : {$results->durationMs}ms\n";

foreach ($results->results as $r) {
    echo "  {$r->civilite} {$r->prenomExercice} {$r->nomExercice}";
    echo " — {$r->profession->libelle}";
    echo " — {$r->libelleCommune}\n";
}

// ── Pagination ──────────────────────────────────────────────────

$page2 = $client->search(new RppsSearchCriteria(nom: 'MARTIN'), page: 2, pageSize: 50);

use QrCommunication\RppsApi\RppsClientOptions;

$options = new RppsClientOptions(
    fhirBaseUrl:      'https://gateway.api.esante.gouv.fr/fhir/v2',  // URL de base FHIR ANS
    fhirApiKey:       'votre-cle-esante-api-key',                    // Clé API Gravitee (optionnel)
    tabularBaseUrl:   'https://tabular-api.data.gouv.fr/api/resources', // URL Tabular data.gouv.fr
    timeout:          30.0,                                           // Timeout Guzzle en secondes
    tabularPageSize:  100,                                            // Taille de page pour les requêtes Tabular
    disabledSources:  ['fhir', 'mssante'],                           // Sources à désactiver
);

use QrCommunication\RppsApi\Enum\SourceName;

SourceName::Fhir->value;             // 'fhir'
SourceName::PersonneActivite->value; // 'personne-activite'
SourceName::Diplomes->value;         // 'diplomes'
SourceName::SavoirFaire->value;      // 'savoir-faire'
SourceName::CarteCps->value;         // 'carte-cps'
SourceName::Mssante->value;          // 'mssante'

use QrCommunication\RppsApi\Exception\RppsException;

// ── Cas 1 : RPPS invalide ───────────────────────────────────────
try {
    $profil = $client->getByRpps('123');
} catch (RppsException $e) {
    // "Numéro RPPS invalide : "123". Le RPPS doit contenir exactement 11 chiffres."
    echo $e->getMessage();
}

// ── Cas 2 : aucun critère de recherche ─────────────────────────
try {
    $results = $client->search(new RppsSearchCriteria());
} catch (RppsException $e) {
    // "Au moins un critère de recherche est obligatoire (nom, prenom ou codePostal)."
    echo $e->getMessage();
}

// ── Cas 3 : erreur source (silencieuse, consultable après coup) ─
$profil = $client->getByRpps('10005173140');

foreach ($profil->sources as $source) {
    if (!$source->success) {
        // La source a échoué, mais le reste du profil est disponible
        echo "[{$source->source->value}] ERREUR : {$source->error}\n";
    }
}

$client = new RppsClient(new RppsClientOptions(
    fhirApiKey: $_ENV['ESANTE_API_KEY'], // ou getenv('ESANTE_API_KEY')
));

bash vendor/qrcommunication/rppsapi/skill/install.sh