API StructureCalcs

Le même solveur que celui du site — résolvez poutres et treillis, interrogez 2 600+ profilés et générez des diagrammes, en HTTP. Conçu pour les assistants IA, les ingénieurs, les étudiants et les établissements.

Démarrage rapide

Charges : négatif = vers le bas. Une charge répartie vers le bas s’écrit start: -10 — la seule convention à connaître avant votre premier appel. Ci-dessous, un appel complet et fonctionnel : une poutre sur deux appuis simples de 6 m sous une charge répartie de 10 kN/m. Aucune clé n’est requise ; le palier anonyme gratuit répond immédiatement. Le même moteur fait tourner le site — comment les résultats sont vérifiés.

curl -X POST https://api.structurecalcs.com/v1/beam/solve \
  -H 'Content-Type: application/json' \
  -d '{
    "units": "SI",
    "spans":    [{ "length": 6, "E": 200, "I": 1e8 }],
    "supports": [{ "type": "pin", "position": 0 },
                 { "type": "roller", "position": 6 }],
    "loads":    [{ "type": "udl", "start": -10, "from": 0, "to": 6 }]
  }'

Réponse

{
  "reactions": [
    { "type": "pin",    "position": 0, "vertical": 30, "moment": 0 },
    { "type": "roller", "position": 6, "vertical": 30, "moment": 0 }
  ],
  "extremes": {
    "moment":     { "maxSagging": { "value": 45, "position": 3 }, ... },
    "deflection": { "max": { "value": -8.44, "position": 3 } }
  },
  "meta": { "engineVersion": "0.1.0+…", "units": "SI", "computeMs": 1 }
}

Tarifs

Des tarifs forfaitaires et publiés — sans facturation à l’appel. Le palier gratuit fonctionne en dix secondes, sans inscription ni vérification d’identité. Chaque résultat est vérifié face à des calculs manuels classiques, et un point de terminaison MCP est prévu pour les assistants IA.

Comment fonctionnent les limites. Trois fenêtres, toutes en UTC : une rafale par minute, un plafond par jour (palier anonyme seulement) et un plafond par mois. Chacune se réinitialise à sa propre échéance — la minute suivante, minuit UTC, le 1er du mois. Dépasser l’une d’elles renvoie 429, en nommant la fenêtre atteinte à la fois dans le détail et dans X-RateLimit-Window, avec un Retry-After propre à cette fenêtre ; les réponses de calcul portent X-RateLimit-Remaining. Votre clé d’API est votre compte — il n’y a ni identifiant ni mot de passe.

PalierTarifComprend
AnonymousFree30/jour · 300/mois · 10/min. Try it instantly, no signup. Shared per IP address.Rien à faire — appelez directement.
StudentFree2 000/mois · 60/min. For students, learning, and evaluation.Your own budget — the anonymous tier is shared per IP, so on a campus or office network it is consumed by whoever else is on it.Demander une clé
Pro$19/mo50 000/mois · 300/min. For commercial projects — includes diagram rendering.
Consultancy$79/mo250 000/mois · 600/min. Team use for a practice or consultancy.
Institution$499/yr100 000/mois · 600/min. A yearly site licence for a school or department.
AI / Enterprise$499/mo1 000 000/mois · 1 200/min. For AI assistants and platforms calling at scale, plus custom volumes.

Les clés étudiantes sont délivrées à la main, généralement sous un jour.

Comment se passe le paiement

Choisissez un palier payant et cliquez sur S’abonner. Vous payez sur une page hébergée par Stripe, dans votre navigateur — jamais dans votre terminal ni dans votre code — et votre clé apparaît juste après, affichée une seule fois. Aucune donnée de carte ne transite par cette API. Vous pouvez gérer ou résilier à tout moment via le portail client de Stripe : il n’y a pas de compte séparé. Onglet fermé ou clé perdue ? Rendez-vous sur votre page de compte et nous vous enverrons par e-mail un lien sécurisé pour gérer la facturation ou réémettre la clé.

Les clés étudiantes restent sur demande (elles sont gratuites), et le palier anonyme ne demande rien du tout.

Questions fréquentes

StructureCalcs a-t-il une API, et est-elle REST ?
Oui. StructureCalcs dispose d’une API REST publique sur api.structurecalcs.com, qui exécute en HTTP le même solveur que le site. Vous envoyez du JSON en POST à des points d’entrée comme /v1/beam/solve et /v1/truss/solve, et les points d’entrée GET servent la bibliothèque de profilés et les normes ; il y a aussi /v1/health et la spécification OpenAPI 3.1 sur /v1/openapi.json. La référence interactive et les démarrages rapides curl, Python et JavaScript à copier-coller se trouvent sur la page /api.
Existe-t-il un serveur MCP pour StructureCalcs, afin que les assistants IA résolvent poutres, treillis et portiques ?
Oui. Un serveur MCP sans état est disponible sur https://api.structurecalcs.com/mcp ; il parle JSON-RPC sur HTTP. Il expose neuf outils : solve_beam, solve_truss, solve_frame, section_properties, get_section, search_sections, render_beam_diagram, render_truss_diagram et render_frame_diagram. Vous pouvez l’ajouter à Claude Code avec « claude mcp add --transport http structurecalcs https://api.structurecalcs.com/mcp », ou coller l’URL comme connecteur personnalisé dans Claude.ai.
Que peut-on résoudre et tracer via l’API StructureCalcs ?
Vous pouvez résoudre des poutres à plusieurs travées (charges ponctuelles, charges réparties uniformes et à variation linéaire — ce qui couvre les formes triangulaire et trapézoïdale —, charges de pression ou surfaciques, et moments appliqués, avec en retour les réactions plus l’effort tranchant, le moment, la rotation et la flèche avec leurs extrêmes), résoudre des treillis plans à nœuds articulés (efforts dans les barres, réactions, tassements d’appui, effets thermiques et de fabrication), interroger les 2 600+ profilés des six normes, et tracer des diagrammes de poutre ou de treillis. Les diagrammes sont renvoyés en SVG. La version actuelle ne propose ni point d’entrée PDF ou PNG, ni générateur de rapports.
L’API StructureCalcs est-elle gratuite, et combien coûte-t-elle ?
Il existe un palier anonyme gratuit, utilisable sans inscription, plafonné à 30 requêtes par jour et 300 par mois et par adresse IP, avec une pointe de 10 par minute. Une clé Étudiant, gratuite elle aussi, porte cela à 2 000 requêtes par mois. Les paliers payants sont Pro à 19 $/mois, Consultancy à 79 $/mois, Institution à 499 $/an et AI/Enterprise à 499 $/mois ; la tarification est forfaitaire, non à l’usage. Les paliers payants sont en libre-service : cliquez sur S’abonner dans la grille tarifaire, payez par carte sur Stripe, et votre clé s’affiche une seule fois — gérez ou résiliez à tout moment dans le portail de facturation Stripe.
Comment s’authentifier auprès de l’API StructureCalcs ?
Le palier anonyme gratuit ne demande aucune authentification : vous pouvez appeler tout de suite. Pour des limites plus élevées, vous envoyez votre clé dans un en-tête HTTP, Authorization: Bearer sc_live_..., et cette clé constitue tout votre compte (il n’y a ni identifiant ni mot de passe). Une clé payante est délivrée dès l’abonnement et le paiement sur Stripe ; une clé Étudiant gratuite est délivrée à la main, sur demande.
Quelles unités et quelles conventions de signe l’API StructureCalcs emploie-t-elle ?
Chaque requête peut fixer les unités en SI (m, kN, kN/m, GPa, mm4) ou en impérial (ft, kip, k/ft, ksi, in4), comme sur le site ; en l’absence du champ, le SI s’applique. La seule règle de signe à retenir : les charges sont négatives vers le bas, donc une charge uniforme de pesanteur s’écrit start: -10 ; les tassements d’appui sont eux aussi négatifs vers le bas, et les efforts de barre reviennent traction positive, compression négative.

Référence de l’API

Le contrat complet — chaque point de terminaison, schéma et erreur — généré à partir de la spécification OpenAPI 3.1.

Conditions d’utilisation

En utilisant l’API StructureCalcs, vous acceptez ces conditions ainsi que les conditions d’utilisation et la politique de confidentialité du site.

  • Usage acceptable. Utilisez l’API pour ce à quoi elle est destinée — résoudre des modèles de structures, interroger la bibliothèque de profilés et générer des diagrammes. N’essayez pas de la surcharger, de contourner les limites d’usage, de revendre l’accès brut ni de vous en servir pour exploiter un solveur hébergé concurrent.
  • Aucune garantie ; ne remplace pas le jugement de l’ingénieur. Les résultats sont fournis « en l’état », sans garantie d’aucune sorte. L’API est un outil de calcul — un ingénieur qualifié reste responsable de la vérification et de la validation de toute conception.
  • Les limites et les paliers peuvent évoluer. Limites de débit, quotas, définition des paliers et tarifs peuvent changer moyennant un préavis raisonnable, à mesure que le service évolue.
  • Les clés peuvent être révoquées. Une clé d’API qui abuse du service — contournement des limites, atteinte à la disponibilité ou manquement à ces conditions — peut être bridée ou révoquée.

Des questions ? Écrivez-nous.

Verifying your link…