📡 Strawberry Creek API

The Strawberry Creek Monitoring API provides authenticated access to real-time and historical environmental sensor data. Query data by creek site, time range, and variables — and build on top of our open-source water monitoring system.

🔗 Endpoint

GET /api/creek-data/

🔐 Authentication

All requests require a token in the header:

Authorization: Token your_token_here

📥 Required Parameters

• site — table name (e.g. fancy_1)
• start — start time (ISO 8601 format)
• end — end time (ISO 8601 format)

🎛 Optional Parameters

• vars — repeatable param to filter specific columns (e.g. vars=timestamp&vars=Meter_Hydros21_Cond)

🧪 Example Request

curl -H "Authorization: Token abc123..." \"https://www.strawberrycreek.org/api/creek-data/?site=fancy_1&start=2025-04-01T00:00:00&end=2025-04-07T00:00:00&vars=timestamp&vars=Meter_Hydros21_Cond"

📦 Example Response

[
  {
    "timestamp": "2025-04-06 01:45:00",
    "Meter_Hydros21_Cond": 419.7
  },
  {
    "timestamp": "2025-04-06 02:00:00",
    "Meter_Hydros21_Cond": 419.7
  }
]

📤 Upload Sensor Data

Send new sensor data to a specific creek site (table).

🔗 Endpoint

POST /api/upload-sensor-data/

🔐 Authentication

Same as GET: provide your token in the request header.

Authorization: Token your_token_here

📥 Required JSON Fields

• site — table name (e.g. fancy_1)
• timestamp — ISO datetime (e.g. 2025-05-01T13:00:00)

🎛 Optional JSON Fields

• Meter_Hydros21_Cond
• Meter_Hydros21_Depth
• Meter_Hydros21_Temp
• EnviroDIY_Mayfly_Batt
• EnviroDIY_Mayfly_Signal
• TE_TR_525USW_Precip_5minTotal
• Sensirion_SHT40_Humidity
• Sensirion_SHT40_Temperature
• AOSong_AM2315C_Temp
• AOSong_AM2315C_Humidity

🧪 Example Request

curl -X POST https://www.strawberrycreek.org/api/upload-sensor-data/ \
  -H "Authorization: Token your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "fancy_1",
    "timestamp": "2025-05-01T13:00:00",
    "Meter_Hydros21_Cond": 123.45,
    "EnviroDIY_Mayfly_Batt": 3.9
  }'

📦 Success Response

{
  "message": "Data inserted successfully."
}

🚫 Error Responses

• 400 — Missing or invalid parameters
• 404 — Site/table not found
• 401 — Authentication credentials were not provided
• 500 — Internal server error

📮 Need a Token?

Email us at strawberrycreekintern@gmail.com to get your personal access token.

Already have an account? Fill out this form

Username: Password: Generate Token