Sluby
REST APIStorage

Per-asset Sia storage breakdown.

Objects the indexer cannot describe right now are listed in unavailable_object_ids rather than failing the request.

GET
/api/v1/assets/{id}/sia

Objects the indexer cannot describe right now are listed in unavailable_object_ids rather than failing the request.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A Sluby API key (sluby_...) sent as Authorization: Bearer <key>. Keys carry scopes: upload, read, manage.

Path Parameters

id*string

Asset id.

Response Body

Storage breakdown.

application/json
  1. response

Per-asset Sia storage breakdown from the indexer. Objects packed into the same slab share it; totals count each slab and sector once.

manifest_object_id?string|null
objects?array<>
unavailable_object_ids?array<string>

Objects the indexer could not describe on this request.

totals?
hosts?array<>
countries?array<>
contracts?array<string>|

Active file contracts on these hosts; null without an indexd admin API.

indexer?
Example Request
curl -X GET 'https://sluby.example.com/api/v1/assets/string/sia'
Example Response
{  "manifest_object_id": "string",  "objects": [    {      "object_id": "string",      "role": "master_manifest",      "rendition": "string",      "size": 0,      "encoded_size": 0,      "slab_count": 0,      "sector_count": 0,      "shared_slab_count": 0,      "host_count": 0,      "created_at": "2019-08-24T14:15:22Z"    }  ],  "unavailable_object_ids": [    "string"  ],  "totals": {    "object_count": 0,    "raw_bytes": 0,    "encoded_bytes": 0,    "unique_slab_count": 0,    "unique_sector_count": 0,    "sector_bytes": 0,    "data_shards": 0,    "parity_shards": 0,    "redundancy_ratio": 0,    "host_count": 0,    "country_count": 0  },  "hosts": [    {      "public_key": "string",      "sectors": 0,      "country_code": "string",      "latitude": 0,      "longitude": 0,      "good_for_upload": true    }  ],  "countries": [    {      "country_code": "string",      "hosts": 0,      "sectors": 0    }  ],  "contracts": [    "string"  ],  "indexer": {    "url": "string",    "network": "string",    "wallet_address": "string"  }}