EcoSyno Integration Guide

Overview Getting Started Module Catalog Subscription Tiers API Reference Integration Examples Embeddable Widgets Webhooks & Events Data Model AI Integration

Need Help?

Contact our integration support team for assistance with your integration project.

Get Support

Platform Overview

EcoSyno is a comprehensive sustainable lifestyle platform that empowers users to track environmental impact through intelligent, interactive technologies. The platform is designed with a modular architecture covering Environment, Wellness, Kitchen, Marketplace, and other sustainability domains.

Modular Design

Our platform is built with a modular architecture allowing for seamless integration of specific functionality into your application.

RESTful API

Access all platform features through our comprehensive REST API with JSON responses and OAuth 2.0 authentication.

AI-Powered

Leverage our built-in AI capabilities for sustainable lifestyle recommendations and environmental impact analysis.

Privacy-First

Our platform emphasizes privacy with device fingerprinting authentication and no email requirement for basic access.

Key Components

Environment Module

Track water usage, energy consumption, and manage plant health monitoring.

Wellness Module

Meditation tools, health tracking, and sustainable lifestyle coaching.

Kitchen Module

Smart fridge management, waste reduction, and sustainable recipe suggestions.

Wardrobe Module

Sustainable fashion tracking, clothing lifecycle management, and ethical brand finder.

Marketplace Module

Eco-friendly product discovery, local sustainable vendor directory, and carbon offset purchasing.

Analytics Core

Cross-module data visualization, impact tracking, and personalized sustainability scoring.

Getting Started

Follow these steps to start integrating with the EcoSyno platform:

Register for API Access

Choose a Subscription Plan

Authentication Setup

Our platform supports OAuth 2.0, API key, and device fingerprinting authentication methods.

// Example OAuth 2.0 Authentication
const response = await fetch('https://api.ecosyno.app/oauth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    client_id: 'YOUR_CLIENT_ID',
    client_secret: 'YOUR_CLIENT_SECRET',
    grant_type: 'client_credentials'
  })
});

const auth = await response.json();
const token = auth.access_token;
                                    

Choose Your Integration Path

EcoSyno offers multiple integration approaches based on your needs:

REST API

Full access to all platform features through our comprehensive REST API.

Embeddable Widgets

Add specific EcoSyno features directly into your website with just a few lines of code.

Data Webhooks

Receive real-time updates when sustainability data changes in the platform.

Start Building

Explore our module catalog and API reference to start building your integration:

Browse Modules API Reference Integration Examples

Module Catalog

EcoSyno offers a comprehensive suite of sustainability modules that can be integrated individually or as part of a complete solution:

Essential Tier

Environment Module

Track and optimize your environmental impact with comprehensive monitoring tools.

Features

Water quality monitoring
Energy consumption tracking
Plant health monitoring
Sustainability scoring
IoT device integration

API Endpoints

/api/environment/water
/api/environment/energy
/api/environment/plants
/api/environment/score

Enhanced Tier

Wellness Module

Promote sustainable wellness practices with personalized guidance and tracking.

Features

Meditation timer & guides
Sustainable product recommendations
Personal wellness scoring
Digital detox planning
Eco-friendly health practices

API Endpoints

/api/wellness/meditation
/api/wellness/products
/api/wellness/score
/api/wellness/detox

Essential Tier

Kitchen Module

Optimize food usage and reduce waste with smart kitchen management tools.

Features

Smart fridge inventory
Food waste tracking
Sustainable recipe suggestions
Eco-friendly product alternatives
Local food sourcing guide

API Endpoints

/api/kitchen/fridge
/api/kitchen/waste
/api/kitchen/recipes
/api/kitchen/alternatives

Premium Tier

Wardrobe Module

Transform your fashion choices with sustainable wardrobe management.

Features

Digital wardrobe inventory
Clothing lifecycle tracking
Sustainable brand directory
Outfit carbon footprint calculator
Clothing repair/upcycle guides

API Endpoints

/api/wardrobe/inventory
/api/wardrobe/lifecycle
/api/wardrobe/brands
/api/wardrobe/carbon

Premium Tier

Marketplace Module

Connect with sustainable products, services, and local eco-friendly options.

Features

Sustainable product directory
Local vendor mapping
Carbon offset purchasing
Product impact comparisons
Community sharing marketplace

API Endpoints

/api/marketplace/products
/api/marketplace/vendors
/api/marketplace/offsets
/api/marketplace/sharing

View Subscription Plans

Subscription Tiers

EcoSyno offers multiple subscription tiers to match your integration needs:

Essential Tier

Core Sustainability Tracking

Perfect for basic integrations focused on environmental impact tracking.

Environment Module (Basic)
Kitchen Module (Basic)
Wellness Core Features
Basic API Access (500 requests/day)
Standard Support

Enhanced Tier

Advanced Sustainable Living

Expanded access for comprehensive sustainability applications.

All Essential Features
Wardrobe Module
Budget Tracking
Community Features
Advanced API Access (2,000 requests/day)
Priority Support

Premium Tier

Complete Eco Platform

Full platform access with AI-powered features and advanced analytics.

All Enhanced Features
AI-Powered Recommendations
Marketplace Module
Advanced Health Tools
Premium API Access (10,000 requests/day)
Dedicated Support
White-label Options

Elite Tier

Enterprise Integration

Custom enterprise solutions with dedicated infrastructure and support.

All Premium Features
Custom Module Development
Dedicated Infrastructure
Unlimited API Access
24/7 Enterprise Support
Custom Integration Services
Data Migration Assistance

View Detailed Subscription Plans

API Reference

The EcoSyno API follows RESTful principles and returns JSON responses. All endpoints require authentication and are versioned.

Authentication

All API requests require an authentication token passed in the Authorization header:

// Token authentication
fetch('https://api.ecosyno.app/v1/environment/water', {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
})
.then(response => response.json())
.then(data => console.log(data));
                                    

Environment API

GET /api/environment/water
Get water quality metrics and usage data

GET /api/environment/energy
Get energy consumption metrics and trends

GET /api/environment/plants
Get plant health monitoring data

POST /api/environment/score/calculate
Calculate environmental impact score based on provided metrics

Wellness API

GET /api/wellness/meditation/sessions
Get meditation session history and recommendations

GET /api/wellness/products/recommended
Get personalized sustainable product recommendations

POST /api/wellness/detox/plan
Create a personalized digital detox plan

Kitchen API

GET /api/kitchen/fridge/inventory
Get current smart fridge inventory

POST /api/kitchen/fridge/inventory
Update smart fridge inventory items

GET /api/kitchen/waste/stats
Get food waste tracking statistics

GET /api/kitchen/recipes/sustainable
Get sustainable recipe recommendations based on inventory

View Full API Documentation

Integration Examples

Here are some common integration scenarios and code examples:

Water Quality Dashboard Integration

This example shows how to fetch and display water quality data from the EcoSyno API:

// Fetch water quality data
async function getWaterQualityData() {
  const response = await fetch('https://api.ecosyno.app/v1/environment/water', {
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
    }
  });
  
  const data = await response.json();
  
  // Display water quality metrics
  const waterQualityChart = new Chart(ctx, {
    type: 'bar',
    data: {
      labels: data.metrics.map(item => item.date),
      datasets: [{
        label: 'Water Quality Score',
        data: data.metrics.map(item => item.quality_score),
        backgroundColor: '#38bdf8'
      }]
    },
    options: {
      responsive: true,
      scales: {
        y: {
          beginAtZero: true,
          max: 100
        }
      }
    }
  });
}

// Call the function
getWaterQualityData();
                                    

Sustainable Recipe Recommendation Widget

This example demonstrates how to integrate the sustainable recipe recommendations into your application:

// HTML Structure // JavaScript Integration async function loadRecipeRecommendations() { // Fetch current inventory first (optional) const inventoryResponse = await fetch('https://api.ecosyno.app/v1/kitchen/fridge/inventory', { headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' } }); const inventory = await inventoryResponse.json(); // Get recipe recommendations based on inventory const recipeResponse = await fetch('https://api.ecosyno.app/v1/kitchen/recipes/sustainable', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ inventory_items: inventory.items.map(item => item.id), preferences: { dietary: ['vegetarian'], exclude: ['dairy'] } }) }); const recipes = await recipeResponse.json(); // Render recipe recommendations const container = document.getElementById('recipe-recommendations'); recipes.recommendations.forEach(recipe => { const recipeCard = document.createElement('div'); recipeCard.className = 'recipe-card'; recipeCard.innerHTML = `

${recipe.title}

Sustainability Score: ${recipe.sustainability_score}/100

Uses ${recipe.inventory_match_percent}% of your current inventory

`; container.appendChild(recipeCard); }); } // Initialize the widget loadRecipeRecommendations();

Embeddable Widgets

EcoSyno provides ready-to-use embeddable widgets that can be added to your website or application with minimal code.

The Widgets documentation is being expanded. Check back soon for more detailed implementation guides.

Webhooks & Events

Subscribe to real-time events from the EcoSyno platform through our webhook system.

The Webhooks documentation is being expanded. Check back soon for more detailed implementation guides.

Data Model

Understand the core data structures used across the EcoSyno platform.

The Data Model documentation is being expanded. Check back soon for more detailed information.

AI Integration

Leverage EcoSyno's AI capabilities for advanced sustainability analysis and recommendations.

The AI Integration documentation is being expanded. Check back soon for more detailed implementation guides.