# HTTP Entry Point

Forward HTTP requests to cloud data ingest services.

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

```bash
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
```