Der Vorgang „Entität lesen“ gibt Eigenschaftswerte für eine Entität in einem Context Graph-Modell zurück.
URL-Format von HTTP-GET-Anforderungen
Die Anforderung wird wie folgt angegeben. Der Spectrum-Server unterstützt sowohl HTTP als auch HTTPS.
GET http://server_name:port/rest/ContextGraph/operations/modelName/entities/entityType/entityLabel
URL-Pfadelemente
- modelName
- Der Name des Context Graph-Modells.
- entityType
- Ein im Modell definierter Entitätstyp
- entityLabel
- Die Beschriftung für eine vorhandene Entität im Modell.
Rückgabecodes
Der Vorgang gibt bei Erfolg den Statuscode „200 OK“ zurück. Der Vorgang gibt den Statuscode „500 (Fehler)“ zurück, wenn er fehlschlägt.
Antwort
Die Antwort gibt ein Name-Wert-Paar für jede Entitätseigenschaft im folgenden Format zurück. Beachten Sie, dass numerische Werte nicht in Anführungszeichen gesetzt werden.
{ "result":{ "property":value, "property":value, ... "property":value }}
JSON-Antwort
Die folgende Anforderung liest Eigenschaften aus dem Entitätstyp „Place“ im Modell „911“ mit der Beschriftung „FlightSafety International“.
GET http://localhost:8080/rest/ContextGraph/operations/911/entities/Place/FlightSafety%20International
Dies führt zu folgender Antwort:
{"result":{ "Latitude":"27.6386433", "Location":"Vero Beach, Florida", "Longitude":"-80.39727", "Place":"FlightSafety International", "Date":1275782400000 }}