> ## Documentation Index
> Fetch the complete documentation index at: https://docs.umeme.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Rend ce que vous pouvez vendre : comptes, montants minimum et maximum, limite du jour et ce qu'il en reste.

Toute clé valide.



## OpenAPI

````yaml openapi/v1.json GET /v1/configuration
openapi: 3.1.0
info:
  title: API Umeme pour les intégrateurs
  version: 1.0.0
  description: >-
    Contrat de l'API Umeme pour les intégrateurs : vendre de l'électricité
    prépayée et des abonnements TV depuis le portefeuille de votre revendeur.
servers:
  - url: https://sandbox.umeme.app
    description: Sandbox d'intégration
  - url: https://api.umeme.app
    description: Production
security:
  - cle: []
tags:
  - name: Ventes
  - name: Compteurs
  - name: Portefeuille
  - name: Outils
paths:
  /v1/configuration:
    get:
      tags:
        - Outils
      summary: Configuration
      description: >-
        Rend ce que vous pouvez vendre : comptes, montants minimum et maximum,
        limite du jour et ce qu'il en reste.


        Toute clé valide.
      operationId: lireConfiguration
      responses:
        '200':
          description: Votre configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Configuration'
              example:
                comptes:
                  - SOCODE
                  - VIRUNGA
                  - TV
                montantMin: 0.5
                montantMax: 5000
                limiteJour: 500
                resteJour: 435
        '401':
          $ref: '#/components/responses/NonAuthentifie'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl "$UMEME_BASE_URL/configuration" \
              -H "Authorization: Bearer $UMEME_CLE"
        - lang: javascript
          label: Node.js · fetch
          source: |-
            // Node.js 18 et plus : fetch est intégré.
            const baseUrl = process.env.UMEME_BASE_URL;

            const reponse = await fetch(`${baseUrl}/configuration`, {
              headers: {
                Authorization: `Bearer ${process.env.UMEME_CLE}`,
              },
            });
            const donnees = await reponse.json();
        - lang: javascript
          label: Node.js · Axios
          source: |-
            // npm install axios
            import axios from "axios";

            const umeme = axios.create({
              baseURL: process.env.UMEME_BASE_URL,
              headers: { Authorization: `Bearer ${process.env.UMEME_CLE}` },
              timeout: 30000,
            });

            const { data } = await umeme.get("/configuration");
        - lang: python
          label: Python
          source: |-
            import os

            import requests

            BASE_URL = os.environ["UMEME_BASE_URL"]
            ENTETES = {"Authorization": f"Bearer {os.environ['UMEME_CLE']}"}

            reponse = requests.get(
                f"{BASE_URL}/configuration",
                headers=ENTETES,
                timeout=30,
            )
            donnees = reponse.json()
        - lang: php
          label: PHP
          source: |-
            // composer require guzzlehttp/guzzle
            $client = new GuzzleHttp\Client([
                'base_uri' => getenv('UMEME_BASE_URL') . '/',
                'headers' => ['Authorization' => 'Bearer ' . getenv('UMEME_CLE')],
                'timeout' => 30,
            ]);

            $reponse = $client->get('configuration');
            $donnees = json_decode($reponse->getBody(), true);
        - lang: java
          label: Java
          source: >-
            // Java 15 et plus : java.net.http et blocs de texte.

            var baseUrl = System.getenv("UMEME_BASE_URL");

            var client = HttpClient.newHttpClient();


            var requete = HttpRequest.newBuilder(URI.create(baseUrl +
            "/configuration"))
                .header("Authorization", "Bearer " + System.getenv("UMEME_CLE"))
                .GET()
                .build();

            var reponse = client.send(requete,
            HttpResponse.BodyHandlers.ofString());
components:
  schemas:
    Configuration:
      type: object
      required:
        - comptes
        - montantMin
        - montantMax
        - limiteJour
        - resteJour
      properties:
        comptes:
          type: array
          items:
            $ref: '#/components/schemas/Compte'
          description: Les comptes autorisés.
        montantMin:
          type: number
          description: Montant minimum par vente, en dollars.
        montantMax:
          type: number
          description: Montant maximum par vente, en dollars.
        limiteJour:
          type: number
          description: Total des ventes permis par jour, en dollars.
        resteJour:
          type: number
          description: Ce qu'il reste de la limite du jour, en dollars.
    Compte:
      type: string
      enum:
        - SOCODE
        - VIRUNGA
        - TV
      description: Ce que l'on vend, et chez quel fournisseur.
    Erreur:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: 'Stable : il ne se renomme jamais. C''est lui que votre code compare.'
        message:
          type: string
          description: En français, pour vos journaux. Il peut changer.
  responses:
    NonAuthentifie:
      description: >-
        Clé absente, inconnue, révoquée, ou de l'autre environnement :
        `CLE_INVALIDE`, `CLE_REVOQUEE`, `CLE_MAUVAIS_ENVIRONNEMENT`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erreur'
          example:
            code: CLE_INVALIDE
            message: La clé est absente ou inconnue.
  securitySchemes:
    cle:
      type: http
      scheme: bearer
      description: >-
        Votre clé d'API : `umeme_test_…` dans la sandbox, `umeme_live_…` en
        production.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.