129 lines
2.0 KiB
Markdown
129 lines
2.0 KiB
Markdown
# HTTP Methods
|
|
|
|
## API v1
|
|
|
|
Unless otherwise noted, all URIs take a POST command.
|
|
|
|
### Queries and Results
|
|
|
|
#### `/api/v1/query/gremlin`
|
|
|
|
POST Body: Javascript source code of the query
|
|
|
|
Response: JSON results, depending on the query.
|
|
|
|
#### `/api/v1/query/mql`
|
|
|
|
POST Body: JSON MQL query
|
|
|
|
Response: JSON results, with a query wrapper:
|
|
```json
|
|
{
|
|
"result": <JSON Result set>
|
|
}
|
|
```
|
|
|
|
If the JSON is invalid or an error occurs:
|
|
|
|
```json
|
|
{
|
|
"error": "Error message"
|
|
}
|
|
```
|
|
|
|
|
|
### Query Shapes
|
|
|
|
Result form:
|
|
|
|
```json
|
|
{
|
|
"nodes": [{
|
|
"id" : integer,
|
|
"tags": ["list of tags from the query"],
|
|
"values": ["known values from the query"],
|
|
"is_link_node": bool, // Does the node represent the link or the node (the oval shapes)
|
|
"is_fixed": bool // Is the node a fixed starting point of the query
|
|
}],
|
|
|
|
"links": [{
|
|
"source": integer, // Node ID
|
|
"target": integer, // Node ID
|
|
"link_node": integer // Node ID
|
|
}]
|
|
}
|
|
```
|
|
|
|
#### `/api/v1/shape/gremlin`
|
|
|
|
POST Body: Javascript source code of the query
|
|
|
|
Response: JSON description of the last query executed.
|
|
|
|
#### `/api/v1/shape/mql`
|
|
|
|
POST Body: JSON MQL query
|
|
|
|
Response: JSON description of the query.
|
|
|
|
### Write commands
|
|
|
|
Responses come in the form
|
|
|
|
200 Success:
|
|
```json
|
|
{
|
|
"result": "Success message."
|
|
}
|
|
```
|
|
|
|
400 / 500 Error:
|
|
```json
|
|
{
|
|
"error": "Error message."
|
|
}
|
|
```
|
|
|
|
#### `/api/v1/write`
|
|
|
|
POST Body: JSON quads
|
|
|
|
```json
|
|
[{
|
|
"subject": "Subject Node",
|
|
"predicate": "Predicate Node",
|
|
"object": "Object node",
|
|
"label": "Label node" // Optional
|
|
}] // More than one quad allowed.
|
|
```
|
|
|
|
Response: JSON response message
|
|
|
|
|
|
#### `/api/v1/write/file/nquad`
|
|
|
|
POST Body: Form-encoded body:
|
|
* Key: `NQuadFile`, Value: N-Quad file to write.
|
|
|
|
Response: JSON response message
|
|
|
|
Example:
|
|
```
|
|
curl http://localhost:64210/api/v1/write/file/nquad -F NQuadFile=@30k.n3
|
|
```
|
|
|
|
#### `/api/v1/delete`
|
|
|
|
POST Body: JSON quads
|
|
|
|
```json
|
|
[{
|
|
"subject": "Subject Node",
|
|
"predicate": "Predicate Node",
|
|
"object": "Object node",
|
|
"label": "Label node" // Optional
|
|
}] // More than one quad allowed.
|
|
```
|
|
|
|
Response: JSON response message.
|