calco2la.to
Proof of concept

Connectors for provider-neutral emission API integration

The calco2la.to connector libraries are an early proof of concept for integrating emission calculation APIs through a stable, provider-neutral abstraction layer.

Why this matters

Instead of binding a specialist application directly to one calculation provider, the connector approach separates application logic from provider-specific request and response formats. The goal is to make CO₂ calculation more testable, replaceable and governable over time.

Target audience

Who this is for

The connector approach is meant for organizations and software projects that need more than a one-off calculator call.

Architecture

Why connectors?

A connector layer turns provider-specific APIs into a governable integration boundary.

Avoid provider lock-in

Applications should not have to know every provider-specific API detail. A connector layer makes switching, testing and comparing providers easier.

Full governance power

Provider choice, calculation policy and supported features should remain transparent and configurable rather than disappearing into custom code.

Enable testing and comparison

The same domain request can be mapped to different providers, making side-by-side testing and migration paths possible.

Support replayability

calco2la.to is designed around repeatable, transparent calculation responses that include the parameters needed to understand and document a result.

Open source

Repository overview

The repositories show the connector direction. Java is currently the working example; Python and PHP are prepared as implementation targets.

Design principles

What is already clear?

Even in proof-of-concept state, the architectural target is clear enough to guide implementation and evaluation.

  • The target architecture is provider-neutral: application code should call a stable domain interface, while provider-specific mapping happens in connectors.
  • Flight emission calculation is the first main use case, with request and response structures designed around airport-based routes, passenger counts, travel class, RFI and price-per-ton options.
  • The calco2la.to API concept supports multiple flights in one request envelope and uses API-key based access.
  • Responses should contain enough calculation data to document and repeat the result, while sensitive credentials such as API keys are not repeated in the response.
  • Provider metadata is part of the intended direction: a client should be able to understand which features a provider supports, for example signing, multi-flight requests or specific input formats.
Roadmap

What is still in progress?

The public repositories are intentionally transparent about the current proof-of-concept state.

Important: This page describes the current proof-of-concept state. Some features already designed in the general scheme.json and the newest providers.xml are not yet published in the public repositories.

Schema consolidation

The shared request and response schema is being refined so that providers can be described and mapped consistently across languages.

Provider configuration

The providers.xml concept is intended to describe provider-specific endpoints, capabilities and mappings without hardcoding every provider into application logic.

Language parity

The Java implementation currently acts as the working example. Python and PHP are planned to follow the same structure once the shared schema and provider metadata stabilize.

Provider coverage

The long-term goal is to support multiple emission calculation providers through the same domain model, allowing tests, comparisons and controlled migration paths.

Process

Intended integration model

The connector layer creates a stable boundary between specialist applications and provider-specific APIs.

  1. A specialist application creates a domain-level emission request, for example a flight calculation request.
  2. The connector library validates and normalizes the request according to the shared schema.
  3. A configured provider mapping translates the request into the provider-specific API format. Currently reviewed providers likely to be supported:
    • Atmosfair Webservice 5
    • Google Travel Impact Model (various versions)
    • myclimate Flight Calculator V1 & V2
    • myclimate Bulk Flight Calculator
    • GoClimate Flight Footprint
    • C-Level Carbon Balance API
    • KlimaLink API
    • KlimAPI Calculation & Compensation API (v1 & v2)
    • calco2la.to
  4. The provider response is mapped back into a stable domain response.
  5. The application receives a documented, comparable result without being tightly coupled to one provider API.

Planning an integration or pilot?

We can help evaluate whether the connector approach fits your system landscape, provider strategy and governance requirements.