Alien Proxy Protocol¶
Alien Proxy allows you to send requests to the spacecraft in orbit using our antenna.
It’s a simple HTTP server.
Base Url¶
Send a Request to Spacecraft¶
Pass modulated string in the request body with a Content-Type: text/plain
HTTP header.
Relative URL: /aliens/send
Sample request:
POST /aliens/send HTTP/1.1
1101000
Possible Responses¶
200 OK¶
You will get this response if the spacecraft responds fast enough.
Response body will contain modulated spacecraft response with a Content-Type: text/plain
HTTP header.
Sample response:
HTTP/1.1 200 OK
1101100001110111110111101010101011100
302 Found¶
You will get this response if the spacecraft doesn’t respond fast enough.
If the spacecraft doesn’t respond fast enough we return 302 Found
status code.
The Location
response HTTP header will contain an URL where you can ask for the response again later.
In fact, this header will always contain /aliens/{responseId}
.
It’s a long-polling protocol, so you can make a new request to this location immediately after you got it.
Many HTTP client implementations, e.g. C#’s HttpClient
, can follow redirects automatically, so you don’t deal with this.
Sample response:
HTTP/1.1 302 Found
Location: /aliens/75960227-653C-47E3-A47A-118A46AFFD4C
Get a Response From Spacecraft¶
Use this to get a response to the request you have sent earlier, in case the spacecraft didn’t respond fast enough.
Relative URL: /aliens/{responseId}
Possible responses are the same as in /aliens/send
.