Versioning de l'API AIOrouter
Document Type : Spécification de l'API
Version : 1.1.0
Date : 2026-06-07
Version actuelle de l'API :2026-06-07
§1 — Versioning Scheme
AIOrouter utilise un système de versioning double :
| Mécanisme | Objectif | Exemple |
|---|---|---|
Chemin d'URL (/v1/) |
Forme de l'API : chemins des points de terminaison, structure des réponses | /v1/chat/completions |
En-tête (API-Version) |
Comportement sémantique : calendrier de dépréciation, activation de fonctionnalités | API-Version: 2026-06-07 |
Versioning des chemins d'URL
/v1/représente la première génération de la forme de l'API- Les modifications majeures (renommer un point de terminaison, restructurer les réponses) entraîneront l'incrémentation vers
/v2/ /v1/reste disponible comme alias hérité pour la version actuelle
Versioning par en-tête
- Toutes les requêtes devraient inclure l'en-tête
API-Versionavec une version basée sur la date - En cas d'omission, le serveur utilise par défaut la version actuelle (
2026-06-07) - Toutes les réponses incluent l'en-tête
API-Versionindiquant la version utilisée - Les versions dépréciées incluent l'en-tête
Sunsetavec la date de suppression - Les versions dépréciées incluent l'en-tête
API-Version-Warning
§2 — Current Version : 2026-06-07
Version actuelle de l'API avec la forme suivante :
| Méthode | Chemin | Description |
|---|---|---|
POST |
/v1/chat/completions |
Génération de réponse de chat (avec ou sans streaming) |
GET |
/v1/models |
Liste des modèles disponibles |
GET |
/v1/models/:modelId |
Détails d'un modèle spécifique |
Fonctionnalités supportées :
- Génération de réponse avec messages, temperature, max_tokens, top_p, stop
- Streaming (SSE) via
stream: true - Appel de fonctions (outils + choix d'outil)
- Sortie structurée (response_format : json_object | text)
- Authentification par clé API (jeton Bearer dans l'en-tête Authorization)
§3 — Deprecation Policy
| Politique | Valeur |
|---|---|
| Compatibilité descendante | 12 mois à partir de l'annonce de dépréciation |
| Avis de fin de vie | 3 mois avant suppression via l'en-tête Sunset |
| Guide de migration | Publié dans la documentation pour chaque transition de version |
| Période Grace | Les versions dépréciées renvoient l'en-tête API-Version-Warning |
§4 — Version History
| Version | Release Date | Statut | Sunset Date |
|---|---|---|---|
2026-06-07 |
2026-06-07 | ✅ Actuelle | — |
2026-06-01 |
2026-06-01 | ⚠️ Dépréciée | 2027-06-01 |
§5 — Client Requirements
Required Headers
Authorization: Bearer ak- + 43 caractères base64url
Content-Type: application/json
Recommended Headers
API-Version: 2026-06-07
X-Request-Id: <uuid-v4>
Compatibilité des SDK
AIOrouter est compatible avec le SDK OpenAI. Définissez l'URL de base :
# Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.aiorouter.ca/v1",
api_key="ak-..."
)
// TypeScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.aiorouter.ca/v1",
apiKey: "ak-...",
});