Lire les droits d’un patient

POST/v1/coverages

Chaque lecture crée une nouvelle Coverage, et le patient s’il est nouveau. Une Coverage ne se modifie jamais. source: manual saisit les droits en mode dégradé.

Droit de clé restreinte : patients:write.

Corps de la requête

sourceénumérationobligatoire
D'où viennent les droits.
vitale_cardvitale_appadrimanual
cardtexte
Le support à lire. En mode test, un scénario de /v1/test-helpers/scenarios.
patienttexte
Le mode dégradé : un patient connu, ou un bénéficiaire saisi.
beneficiaryobjet
Champs de beneficiary
- nirtexte
- first_nametexte
  Le prénom.
- last_nametexte
  Le nom.
- birth_datetexte
- rankentier
- qualityénumération
  insuredspousechildother
- insured_first_nametexteou null
- insured_last_nametexteou null
rightsénumération
openclosed
regime_codetexte
fund_codetexte
center_codetexte
exemptionstableau de texte
complementarytableau de texte
valid_untildate

En-têtes

Idempotency-Keytexte
Rend le rejeu de cette écriture sûr pendant 24 heures. Idempotence.

Réponse

Rend l’objet droits.

Une erreur suit le format commun.

Requête

curl


curl -X POST https://api.ophelix.fr/v1/coverages \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"source":"vitale_card","card":"vitale_ok"}'

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.ophelix.fr']);
 
$response = $client->post('/v1/coverages', [
    'headers' => ['Authorization' => 'Bearer sk_test_…'],
    'json' => [
        'source' => 'vitale_card',
        'card' => 'vitale_ok',
    ],
]);
$object = json_decode((string) $response->getBody(), true);

TypeScript


const response = await fetch('https://api.ophelix.fr/v1/coverages', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_test_…', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    source: 'vitale_card',
    card: 'vitale_ok'
  }),
})
const object = await response.json()

Réponse 201


{
  "id": "cov_034t7h7Z8puJCJmZpYBTli",
  "object": "coverage",
  "patient": "pat_034suQ2fyOnQtlR2EbxM0C",
  "source": "vitale_card",
  "rights": "open",
  "regime_code": "01",
  "fund_code": "751",
  "center_code": "0001",
  "exemptions": [],
  "complementary": null,
  "read_at": 1794004693,
  "valid_until": "2030-12-31",
  "livemode": false,
  "created": 1794004693
}