Skip to content

Item Generic badge Generic badge

Description

REST endpoint to retrieve a STAC Item. Compliant with version 1.0.0 STAC Item.

URL

https://datasphere.astrodynamic.space/api/item/v1/{package name}
Authentication Required

Generate API Token.

Header Value
Authorization Token {Your Token}

Parameters

Parameter In Required Default Description
package name path Required - Your package name

Response

Content Type
application/json; charset=utf-8
Value Type Description
STAC Item string (UTF-8) Returns UTF-8 JSON encoded string of STAC Item.
STAC Item Schema
Code Description
400 Bad Request
401 API Token is missing or invalid
403 API Token is missing or invalid
404 Invalid URL
500 Internal Server Issue. Please report this to us here

Usage

import requests

url = "https://datasphere.astrodynamic.space/api/item/v1/{package name}"

response = request.get(url, headers={"Authorization":"Token {api token}"})
stac_item = response.json()

Open API Docs

Item 1.0.0

REST endpoint to retrieve a STAC Item.


Servers

Description URL
Data Sphere REST Server https://datasphere.astrodynamic.space/api

Endpoints


GET /item/v1/{package name}

REST endpoint to retrieve STAC Item.

Input parameters

Parameter In Type Default Nullable Description
Authorization header string N/A No
package name path string No Name of Item Package

Response 200 OK

{
    "type": "Feature",
    "bbox": [
        {
            "type": "float"
        }
    ],
    "properties": {},
    "assets": {},
    "links": [
        {}
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "type": "object",
    "properties": {
        "type": {
            "type": "string",
            "enum": [
                "Feature"
            ]
        },
        "bbox": {
            "type": "array",
            "items": {
                "type": "float"
            }
        },
        "properties": {
            "type": "object",
            "properties": {}
        },
        "assets": {
            "type": "object",
            "properties": {}
        },
        "links": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {}
            }
        }
    }
}

Response 400 Bad Request

Response 401 Unauthorized

Refer to the common response description: UnauthorizedError.

Response 403 Forbidden

Refer to the common response description: UnauthorizedError.

Response 404 Not Found

Response 500 Internal Server Error

Refer to the common response description: ServerError.


Schemas

STACItem

Name Type
assets
bbox Array<>
links Array<>
properties
type string

Common responses

This section describes common responses that are reused across operations.

UnauthorizedError

API Token is missing or invalid

ServerError

Internal Server Issue. Please report this to us here.

Security schemes

Name Type Scheme Description
Authorization http token