API: Referenzen einer Perzentilenkurve anzeigen

Jede Perzentilenkurve basiert auf bestimmten Referenzdaten. Die jeweils verwendeten Referenzdaten können in Textform direkt unterhalb der Perzentilenkurve eingeblendet werden, indem der Parameter references=true beim Abruf der Perzentilenkurve über die URL mitgegeben wird.

curl -X PUT -H "API-Key: {API_KEY}" https://api.wachstum.at/api/xml/chart/{TYP}/{FORMAT}?references=true --data "@@patient.xml"

In bestimmten Fällen kann es aber auch wünschenswert sein, die einer Perzentilenkurve zugrunde liegenden Referenzen nicht direkt in der Grafik, sondern an anderer Stelle in einer Anwendung anzuzeigen. Für diese Fälle steht ein eigener API-Endpunkt zur Verfügung, die die jeweils relevanten Referenzdaten einer Perzentilenkurve zurück gibt:

curl -X PUT -H "API-Key: {API_KEY}" https://api.wachstum.at/api/xml/chart/{TYP}/references --data "@@patient.xml"

Diese API-Funktion orientiert sich in ihrer Funktionsweise an der API-Funktion zum Abruf einer Perzentilenkurve. Es werden exakt die selben Parameter übergeben, als Resultat wird aber anstelle einer Grafik (Binärdaten) eine XML-Struktur zurückgegeben, die die sichtbaren Referenzdaten für die konkret übergebenen Werte in strukturierter Form umfasst:

<?xml version="1.0" encoding="utf-8"?>
<references xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <reference>
    <x_axis_value>0</x_axis_value>
    <name>WHO (1)</name>
    <text>WHO Multicentre Growth Reference Study Group, Mercedes de Onis et al: WHO Child Growth Standards. Acta Paediatrica 95 (Suppl 450) (2006).</text>
  </reference>
  <reference>
    <x_axis_value>0</x_axis_value>
    <name>TS (2)</name>
    <text>Gabriele Häusler, Michael Schemper, Herwig Frisch, Peter Blümel, Klaus Schmitt, Engelbert Plöchl: Spontaneous growth in Turner syndrome: Evidence for a minor pubertal growth spurt. Eur J Pediatr 151: 283-287 (1992).</text>
  </reference>
  <reference>
    <x_axis_value>4</x_axis_value>
    <name>APEDÖ (3)</name>
    <text>Andreas Gleiss, Michael Lassi, Peter Blümel, Martin Borkenstein, Klaus Kapelari, Michael Schemper, Michael Mayer, Gabriele Häusler: Austrian Height and Body Proportion References for Children Aged 4 to under 19 Years. Annals of Human Biology 40(4): 324–332 (2013).</text>
  </reference>
</references>