1.9 KiB
1.9 KiB
backend-transcription
Beep backend handling transcription of bites to text via Google Cloud.
Quickstart
go build && ./backend-transcription
Flags
Flags are supplied to the compiled go program in the form -flag=stuff
.
Flag | Description | Default |
---|---|---|
listen | Port number to listen on | 8080 |
nats | URL of NATS | nats://localhost:4222 |
api-key | Google Cloud API key | Something that works. Probably |
API
Scan Bites
GET /conversation/:key/scan
Get a list of transcription start times within a conversation key and specified timespan.
URL Params
Name | Type | Description |
---|---|---|
key | String | Audio transcription's bite's conversation's ID. |
Querystring
Name | Type | Description |
---|---|---|
from | Epoch timestamp | Time to start scanning from |
to | Epoch timestamp | Time to scan to |
Success (200 OK)
Content-Type: application/json
{
"previous": <Timestamp of transcription before <starts>>,
"starts": [Timestamp, Timestamp...],
"next": <Timestamp of transcription after <starts>>,
}
Errors
Code | Description |
---|---|
400 | Malformed input (from/to not timestamp, key not alphanumeric). |
500 | NATs or protobuf serialisation encountered errors. |
Get Bite
GET /conversation/:key/start/:start
Get a specific transcription
.
URL Params
Name | Type | Description |
---|---|---|
key | String | Audio transcription's conversation's ID. |
start | Epoch timestamp | Time the audio transcription starts. |
Success (200 OK)
Plaintext transcription
Errors
Code | Description |
---|---|
400 | start is not an uint/key is not an alphanumeric string/specified bite could not be found |
500 | NATs or protobuf serialisation encountered errors. |