about summary refs log tree commit diff
path: root/README.md
blob: d28ee8cdd474eb45681c18db4d5c467486253913 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# TLE2JSON

http api returning TLEs as json

## Setup

standalone:
`go run . -p <port>`

docker:
```
$ docker build . -t tle2json
$ docker run -p <port extern>:8080 tle2json
```

![](imgs/out.png)

## API

### endpoints

The api will eventually consist of the following endpoints. There is currently
no guarantee that the enpoins will stay like this, this is really early alpha
and may change alot in the next days / weeks:

- `/v1/getall`
    - returns all TLEs
- `/v1/regex/{regex}`
    - returns all the TLEs matching the given `regex`
- `/v1/satid/{satid}`
    - returns all the TLEs with the given `satid`
- `/v1/category/{category}`
    - returns all the TLEs from the named category
    - (the categories are the ones given [here](https://celestrak.com/NORAD/elements/))
- `/v1/category/{category}/satname/{satname}`
    - returns the TLE of the satellite in the given `category` with the given
        `satname`

### parameters

- `?format=json`
    - returns the TLEs as json objects
- `?format=raw`
    - returns the TLE in the raw Two-Line format
- `?values=inclination,argumentofperigee`
    - returns the values given as a comma, seperated list of arguments