Skip to content

Natal Sound: player payload​

POST
/api/sound/natal/timeline

Everything a player needs in one call: a signed URL an <audio> element can load without headers, and the time axis of the piece.

The markers say when each point sounds and which aspects sound with it — enough to light up
a wheel in step with the audio, and deliberately not enough to reconstruct the mapping. No
frequencies, levels, timbres or ratios appear here.

One counted request, not two: the audio URL is signed, so fetching the bytes is free.

Authorizations​

ApiKeyAuth

API key for authentication. Get your API key from the dashboard.

Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
  
"dateTime": "string",
  
"location": {
  
  
"longitude": 0,
  
  
"latitude": 0,
  
  
"timezone": "string"
  
},
  
"houseSystem": "placidus",
  
"points": [
  
  
"string"
  
],
  
"length": "full",
  
"duration": 0,
  
"profile": "kepler",
  
"skipSilence": false,
  
"format": "mp3"
}

Responses​

Signed audio URL and marker timeline

application/vnd.api+json
JSON
{
  
"data": {
  
  
"type": "sound-timeline",
  
  
"attributes": {
  
  
  
"audioUrl": "string",
  
  
  
"format": "string",
  
  
  
"profile": "string",
  
  
  
"duration": 0,
  
  
  
"mappingVersion": 0,
  
  
  
"markers": [
  
  
  
  
{
  
  
  
  
  
"pointId": "string",
  
  
  
  
  
"onset": 0,
  
  
  
  
  
"duration": 0,
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"aspects": [
  
  
  
  
  
  
{
  
  
  
  
  
  
  
"partnerId": "string",
  
  
  
  
  
  
  
"aspect": "string"
  
  
  
  
  
  
}
  
  
  
  
  
]
  
  
  
  
}
  
  
  
]
  
  
}
  
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

AstroAPI Documentation