Soracom Funnel

HTTP Entry Point

This entry point accepts HTTP requests from an Air for Cellular device and forwards the request to the cloud service as an HTTP POST request.

Entry Point

Your device should be configured to send data to: http://funnel.soracom.io.

Behavior

Request

Your device should use a standard HTTP Post request. The request should contain a Content-type header with one of the following values:

• Content-Type: application/json
• Content-Type: text/plain
• Content-Type: application/xml

Response

Funnel will return one of the following HTTP responses based on the request:

• 204 (no content) - Data was successfully sent to cloud service.
• 400 Invalid JSON is send to funnel. - HTTP POST body contained invalid JSON data.
• 413 Maximum content-length is: 800000 - HTTP POST body exceeds the maximum content length.

Example

$ curl -v -H 'Content-Type: application/json' -d '{"key":"value"}' http://funnel.soracom.io
>* Rebuilt URL to: http://funnel.soracom.io/
>*   Trying 100.127.65.43...
>* Connected to funnel.soracom.io (100.127.65.43) port 80 (#0)
>> POST / HTTP/1.1
>> Host: funnel.soracom.io
>> User-Agent: curl/7.49.0
>> Accept: */*
>> Content-Type: application/json
>> Content-Length: 15
>>
>* upload completely sent off: 15 out of 15 bytes
>< HTTP/1.1 204 No Content
>< Date: Tue, 06 Dec 2016 16:19:37 GMT
>< Connection: keep-alive