D3FEND API Documentation

The D3FEND REST API is used to populate the views on the D3FEND website. This is an alpha version API, please send feedback to help improve this community resource.

Endpoint for retrieving D3FEND ontology inbound bindings.

GET

/api/ontology/inference/d3fend-full-mappings.csv

Example API

/api/ontology/inference/d3fend-full-mappings.csv

Returns

Type	Description
OntologyBindings	200 - success response - application/json

Endpoint for retrieving D3FEND ontology inbound bindings.

GET

/api/ontology/inference/d3fend-full-mappings.json

Example API

/api/ontology/inference/d3fend-full-mappings.json

Returns

Type	Description
OntologyBindings	200 - success response - application/json

Endpoint for retrieving SPARQL DESCRIBE results for D3FEND Ontology entities.

GET

/api/ontology/describe/[subject].json

Example API

/api/ontology/describe/d3f:SystemCall.json

Parameters

Name	Type	Description
subject	string	Single D3FEND object/artifact id

Returns

Type	Description
OntologyBindings	200 - success response - application/json

Endpoint for retrieving D3FEND ontology inbound bindings.

GET

/api/ontology/describe/inbound/[subject].json

Example API

/api/ontology/describe/inbound/d3f:SystemCall.json

Parameters

Name	Type	Description
subject	string	Single D3FEND object/artifact id

Returns

Type	Description
OntologyBindings	200 - success response - application/json

Endpoint for retrieving single artifact properties

GET

/api/dao/artifact/[artifact].json

Example API

/api/dao/artifact/d3f:AccessToken.json

Parameters

Name	Type	Description
artifact	string	Name of D3FEND Artifact

Returns

Type	Description
DAOArtifact	200 - success response - application/json

Endpoint for retrieving all D3FEND artifacts.

GET

/api/dao/artifacts.json

Example API

/api/dao/artifacts.json

Returns

Type	Description
ArtifactsGraph	200 - success response - application/json

Endpoint for retrieving D3FEND Matrix in JSON-LD format.

GET

/api/matrix-graph.json

Example API

/api/matrix-graph.json

Returns

Type	Description
Taxonomy	200 - success response - application/json

Endpoint for retrieving D3FEND Matrix in a custom json structure.

GET

/api/matrix.json

Example API

/api/matrix.json

Returns

Type	Description
DAOMatrix[]	200 - success response - application/json

Endpoint for retrieving all ATT&CK-techniques in the D3FEND Ontology.

GET

/api/offensive-technique/all.json

Example API

/api/offensive-technique/all.json

Returns

Type	Description
ATTACKTechniques	200 - success response - application/json

Endpoint for retrieving single ATT&CK technique properties.

GET

/api/offensive-technique/attack/[technique].json

Example API

/api/offensive-technique/attack/T1571.json

Returns

Type	Description
OffensiveTechnique	200 - success response - application/json

Endpoint for retrieving single tactic properties.

GET

/api/tactic/[tactic].json

Example API

/api/tactic/d3f:Harden.json

Parameters

Name	Type	Description
tactic	string	Name of D3FEND tactic Artifact

Returns

Type	Description
Tactic	200 - success response - application/json

Endpoint for retrieving all D3FEND Tactics.

GET

/api/tactic/all.json

Example API

/api/tactic/all.json

Returns

Type	Description
Tactics	200 - success response - application/json

Endpoint for retrieving single technique properties.

GET

/api/technique/[technique].json

Example API

/api/technique/d3f:DataInventory.json

Parameters

Name	Type	Description
technique	string	Name of D3FEND technique Artifact

Returns

Type	Description
Technique	200 - success response - application/json

Endpoint for retrieving all D3FEND Techniques.

GET

/api/technique/all.json

Example API

/api/technique/all.json

Returns

Type	Description
Techniques	200 - success response - application/json

Endpoint for retrieving version and release date of D3FEND.

GET

/api/version.json

Example API

/api/version.json

Returns

Type	Description
VersionData	200 - success response - application/json

Endpoint for retrieving all CWE Weaknesses in D3FEND Ontology.

GET

/api/weakness/all.json

Example API

/api/weakness/all.json

Returns

Type	Description
Weaknesses	200 - success response - application/json

Endpoint for retrieving Taxonomies.

GET

/api/weakness/cwe/[weakness_id].json

Example API

/api/weakness/cwe/CWE-78.json

Parameters

Name	Type	Description
weakness_id	string	CWE Identifier

Returns

Type	Description
Weakness	200 - success response - application/json