Apache Jena SPARQL Query API

SPARQL 1.1 Query operations

OpenAPI Specification

apache-jena-sparql-query-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: Apache Jena Fuseki SPARQL Dataset Management SPARQL Query API
  description: REST API for Apache Jena Fuseki SPARQL server providing SPARQL Query, SPARQL Update, and Graph Store Protocol (GSP) operations for managing RDF datasets.
  version: 5.0.0
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  contact:
    email: users@jena.apache.org
servers:
- url: http://localhost:3030
  description: Apache Jena Fuseki server
tags:
- name: SPARQL Query
  description: SPARQL 1.1 Query operations
paths:
  /{dataset}/sparql:
    get:
      operationId: sparqlQueryGet
      summary: Apache jena Apache Jena Fuseki SPARQL Query via GET
      description: Execute a SPARQL SELECT, CONSTRUCT, ASK, or DESCRIBE query using HTTP GET.
      tags:
      - SPARQL Query
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      parameters:
      - name: dataset
        in: path
        required: true
        schema:
          type: string
        example: ds
        description: Dataset name
      - name: query
        in: query
        required: true
        schema:
          type: string
        example: SELECT * WHERE { ?s ?p ?o } LIMIT 10
        description: SPARQL query string
      - name: default-graph-uri
        in: query
        schema:
          type: string
        description: Default graph URI
        example: https://example.com
      - name: named-graph-uri
        in: query
        schema:
          type: string
        description: Named graph URI
        example: example-name
      responses:
        '200':
          description: SPARQL query results
          content:
            application/sparql-results+json:
              schema:
                $ref: '#/components/schemas/SparqlResults'
            application/sparql-results+xml:
              schema:
                type: string
            text/turtle:
              schema:
                type: string
        '400':
          description: Invalid SPARQL query
    post:
      operationId: sparqlQueryPost
      summary: Apache jena Apache Jena Fuseki SPARQL Query via POST
      description: Execute a SPARQL query using HTTP POST for longer queries.
      tags:
      - SPARQL Query
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      parameters:
      - name: dataset
        in: path
        required: true
        schema:
          type: string
        example: ds
      requestBody:
        required: true
        content:
          application/sparql-query:
            schema:
              type: string
              example: SELECT * WHERE { ?s ?p ?o } LIMIT 10
      responses:
        '200':
          description: SPARQL query results
          content:
            application/sparql-results+json:
              schema:
                $ref: '#/components/schemas/SparqlResults'
components:
  schemas:
    RDFTerm:
      type: object
      description: An RDF term (URI, literal, or blank node)
      properties:
        type:
          type: string
          enum:
          - uri
          - literal
          - bnode
          example: uri
        value:
          type: string
          example: http://example.org/subject
        datatype:
          type: string
          description: Datatype URI for typed literals
        xml:lang:
          type: string
          description: Language tag for language-tagged literals
    SparqlResults:
      type: object
      description: SPARQL query results in JSON format
      properties:
        head:
          type: object
          description: Result metadata including variable names
          properties:
            vars:
              type: array
              items:
                type: string
              example:
              - s
              - p
              - o
        results:
          type: object
          description: Query result bindings
          properties:
            bindings:
              type: array
              items:
                $ref: '#/components/schemas/Binding'
        boolean:
          type: boolean
          description: Result for ASK queries
    Binding:
      type: object
      description: A single result binding
      properties:
        s:
          $ref: '#/components/schemas/RDFTerm'
        p:
          $ref: '#/components/schemas/RDFTerm'
        o:
          $ref: '#/components/schemas/RDFTerm'