Netatmo

{
  "service_type": "platform",
  "base_url": "https://netatmo.net",
  "auth_method": "oauth2",
  "auth_config": {
    "authorization_url": "https://api.netatmo.com/oauth2/authorize",
    "token_url": "https://api.netatmo.com/oauth2/token",
    "scopes": [
      "read_station",
      "read_thermostat",
      "write_thermostat",
      "read_camera",
      "write_camera",
      "read_presence",
      "write_presence",
      "read_homecoach",
      "read_smokedetector",
      "read_carbonmonoxidedetector"
    ],
    "client_id": null,
    "client_secret": null
  },
  "endpoints": [
    {
      "name": "getstationsdata",
      "url": "https://api.netatmo.com/api/getstationsdata",
      "method": "GET",
      "description": "Retrieve data from weather stations"
    },
    {
      "name": "gethomecoachsdata",
      "url": "https://api.netatmo.com/api/gethomecoachsdata",
      "method": "GET",
      "description": "Retrieve data from Home Coach devices"
    },
    {
      "name": "getthermostatsdata",
      "url": "https://api.netatmo.com/api/getthermostatsdata",
      "method": "GET",
      "description": "Retrieve data from thermostats"
    },
    {
      "name": "getmeasure",
      "url": "https://api.netatmo.com/api/getmeasure",
      "method": "GET",
      "description": "Retrieve measurements for a device/module"
    },
    {
      "name": "getevents",
      "url": "https://api.netatmo.com/api/getevents",
      "method": "GET",
      "description": "Retrieve events from cameras or security devices"
    },
    {
      "name": "setthermpoint",
      "url": "https://api.netatmo.com/api/setthermpoint",
      "method": "POST",
      "description": "Set a thermostat setpoint"
    },
    {
      "name": "setroomthermpoint",
      "url": "https://api.netatmo.com/api/setroomthermpoint",
      "method": "POST",
      "description": "Set a room thermostat setpoint"
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "note": "API access is free for developers with rate limits; requires registered app.",
      "limits": "See API rate limits"
    }
  },
  "rate_limits": {
    "general": "Varies by endpoint; typical limit is 500 requests per 10 minutes per user, 50 requests per 10 seconds per app.",
    "source": "https://dev.netatmo.com/apidocumentation"
  },
  "capabilities": [
    "Weather station data retrieval",
    "Home Coach air quality monitoring",
    "Smart thermostat control",
    "Security camera event retrieval",
    "Presence and smoke detector status",
    "Historical measurements",
    "OAuth2 authentication",
    "Swagger/OpenAPI documentation"
  ],
  "raw_analysis": "Netatmo is a smart home device company (part of Legrand) offering weather stations, air quality monitors (Home Coach), thermostats, and security cameras. The platform at netatmo.net hosts a Swagger-based online documentation complementing the official developer portal at dev.netatmo.com. It provides a well-documented REST API with OAuth2 authentication, allowing developers to access device data and control smart home devices. The API is mature, stable, and widely used in home automation integrations (IFTTT, Home Assistant, etc.). It is free to use with reasonable rate limits, though OAuth2 requires creating an app on the developer portal. The service targets developers building smart home applications, dashboards, and automation scripts. The Swagger UI (likely swagger-ui) enables interactive API exploration. While primarily a consumer hardware company, Netatmo offers a robust public API, making it a strong integration candidate for platforms like Prowl."
}

0/3 tests passed

{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 7.5,
    "first_try_success": 5.0,
    "response_parseability": 8.5,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 6.0,
    "latency": 8.0,
    "consistency": 5.5
  },
  "pricing_normalized": {
    "model": "free",
    "api_access": "free with rate limits and registered app required"
  },
  "issues": [
    "SSL certificate hostname mismatch on netatmo.net — cert not valid for this domain, breaking HTTPS checks",
    "Could not verify robots.txt or llms.txt due to TLS failure",
    "No security headers detected (blocked by SSL error)",
    "OAuth2 flow requires registered app credentials, adding onboarding friction for agents",
    "Rate limits on free tier may constrain heavy agent use"
  ],
  "recommendations": [
    "Fix SSL certificate provisioning to include netatmo.net SAN or correct the canonical domain",
    "Publish an llms.txt and confirm robots.txt is agent-friendly",
    "Add clear, per-endpoint rate limit documentation and error codes",
    "Provide a quickstart with copy-paste OAuth2 token exchange and sample cURL requests",
    "Expose a sandbox/test mode to enable first-try success without a physical device",
    "Add standard security headers (HSTS, X-Content-Type-Options) for trust signals"
  ]
}