Cas d’usage
Consommer la spec OpenAPI Scell.io (génération de clients)
Générer un client typé dans n'importe quel langage
Scell.io publie une spec OpenAPI 3.1 complète à `https://api.scell.io/openapi.json` (mise à jour à chaque release). Vous pouvez générer un client typé pour votre stack via `openapi-generator-cli` ou `openapi-typescript` : Java (OkHttp), Go, Rust, Kotlin, Swift, Python, etc. Scell.io maintient officiellement TypeScript (`@scell/sdk`) et PHP (`scell/sdk`) ; les autres langages sont supportés via génération. La spec inclut tous les endpoints, schémas (request / response), codes d'erreur, exemples curl et headers d'authentification. Postman collection également disponible à `https://api.scell.io/postman.json`.
À retenir
- Spec OpenAPI 3.1 à `https://api.scell.io/openapi.json`
- SDKs officiels : TypeScript (`@scell/sdk`), PHP (`scell/sdk`)
- Pas de SDK Python / Go / Java officiel — utiliser openapi-generator
- Postman collection à `/postman.json`
- Versionnement : `info.version` aligné sur les releases backend
- MCP agent (`@scell/mcp-client`) pour Claude / Cursor
Exemple de code
# Génération d'un client Go depuis la spec OpenAPI
curl -o openapi.json https://api.scell.io/openapi.json
npx @openapitools/openapi-generator-cli generate \
-i openapi.json \
-g go \
-o ./scell-client-go \
--additional-properties=packageName=scell
# Ou client TypeScript via openapi-typescript (types only)
npx openapi-typescript https://api.scell.io/openapi.json -o src/scell-types.ts