**Versions de l’API** · [V2 (Latest)](/integrations/v2/docs?lang=fr) · **V1**

> **Cette version de l’API est obsolète.** Utilisez la dernière version pour toute nouvelle intégration. [Voir la documentation actuelle](/integrations/v2/docs?lang=fr)

# Découverte

OpenAPI 3.0.3 · API 1.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v1",
    "description": "API"
  }
]
```

Métadonnées sur la clé API actuelle.

## Opérations

## GET /me

Consulter la clé API, ses autorisations et son organisation

`get_me`

Lire l’identité de la clé appelante, ses autorisations accordées et son organisation, y compris defaultLanguage et enabledLanguages. Utilisez cette opération en lecture seule pour vérifier la clé et l’environnement avant toute écriture. Nécessite une clé API d’organisation valide ; aucune autorisation supplémentaire n’est requise. Le jeton global de catalogue kc_live_* ne peut pas appeler cette opération.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "apiKey": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "prefix": {
                    "type": "string"
                  },
                  "scopes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "organisation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "shortName": {
                    "type": "string"
                  },
                  "defaultLanguage": {
                    "type": "string",
                    "description": "Langue enregistrée à la racine des objets métier multilingues."
                  },
                  "enabledLanguages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Toutes les langues activées, y compris defaultLanguage. Les autres langues sont enregistrées sous forme de surcharges partielles."
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé absente ou invalide",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /associations

Lister les associations de l’organisation

`list_associations`

Liste les associations juridiques de l’organisation (identifiant, libellé, devise) afin de choisir le bon `assoc` lors de la création d’une promesse ou d’un paiement. Aucune autorisation requise.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Association"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_API_KEY"
          }
        }
      },
      "Association": {
        "type": "object",
        "description": "Association juridique (« association »/cerfa) de l’organisation — détermine la devise et le reçu d’un don. Transmettez son `id` comme `assoc` lors de la création d’une promesse/d’un paiement.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant de l’association à utiliser comme `assoc` (\"MAIN\" pour l’association principale de l’organisation)."
          },
          "label": {
            "type": "string",
            "description": "Nom d’affichage."
          },
          "devise": {
            "type": "string",
            "description": "Code de devise de cette association (en minuscules)."
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
