Aura 51 · Contour Réserver un appel

Pour les CTO et lead devs

Ton API n'a pas de doc. Dans 48 h, elle en a une.

Spec OpenAPI complète et SDK typé TypeScript & Python, reconstruits à partir d'une session de ton appli que tu nous autorises à observer. Ton équipe se branche sans deviner. Ton code source reste chez toi.

Pas encore prêt ? Essaie la version gratuite, 100 % dans ton navigateur : HAR → OpenAPI + SDK →

  • 20 min, devis ferme à la fin
  • Accord écrit avant toute capture
  • Zéro accès au code source
session-staging.har Exemple
Observé POST /v2/orders 201
authorization: Bearer ••••••••masqué
{
  "customer_id": "cus_8f2a",
  "items": [{ "sku": "BX-12", "qty": 2 }],
  "coupon": null
}
Spec générée openapi.yaml
OrderCreate:
  type: object
  required: [customer_id, items]  # vus 14/14
  properties:
    customer_id: { type: string }
    items:
      type: array
      items:
        $ref: "#/components/schemas/LineItem"
    coupon:
      type: [string, "null"]  # null 9×/14
Survole un champTouche un champ : chaque règle de la spec renvoie à ce qui a été observé.

Contour en 10 secondes.

Signaux, secrets retirés, programme approximatif : le principe du compilateur, en trois étapes.

Essaie-le sur ton propre HAR →

Vidéo générée avec Grok Imagine. Le présentateur est un avatar IA, pas un membre de l'équipe.

Trois situations où l'absence de doc coûte cher.

  • Le dev qui l'a écrite est parti.

    Personne ne sait plus ce que renvoie /v1/sync, et toute l'équipe a peur d'y toucher.

  • Un nouveau dev arrive lundi.

    Sans doc, il passe sa première semaine à lire du code. Avec la spec, il lit le contrat en une heure.

  • Ton app mobile doit s'y brancher.

    Le SDK typé remplace les essais-erreurs dans Postman et les captures d'écran envoyées sur Slack.

Trois étapes, deux jours ouvrés.

Contour lit le trafic de ta session, masque les secrets, puis déduit le contrat d'API avec un score de confiance pour chaque opération.

  1. J0

    Tu signes l'accord

    Une page : quelle appli, quel environnement, quelle durée. Rien n'est capturé avant ta signature.

  2. J0 à J+2

    On compile ta session

    Tu exportes une session de ton appli (un fichier HAR, en quelques clics depuis le navigateur) ou tu nous ouvres un compte de test. Contour regroupe les appels et déduit les schémas.

  3. J+2

    Tu reçois le pack

    Spec, SDK et rapport de confiance. Tu commites, ton équipe s'en sert le jour même.

Ce qui atterrit dans ton repo.

Quatre fichiers, lisibles par tes devs comme par tes outils. Aperçu d'un pack type, sur une API de commandes fictive.

contour-pack/openapi.yaml
openapi: 3.1.0
info:
  title: Orders API (interne)
  version: 2.0.0
  x-generated-by: contour
servers:
  - url: https://staging.example.com
paths:
  /v2/orders:
    post:
      operationId: createOrder
      summary: Crée une commande
      security: [{ bearerAuth: [] }]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/OrderCreate"
      responses:
        "201": { $ref: "#/components/responses/Order" }
        "422": { $ref: "#/components/responses/Invalid" }
      x-confidence: 0.96  # 14 appels observés
  # … 23 autres opérations

Formats : OpenAPI 3.1, TypeScript 5, Python 3.11+. La spec s'ouvre telle quelle dans Swagger UI, Redoc ou Postman.

Ton code reste chez toi.

Contour ne lit que le trafic HTTP d'une session que tu autorises. Le plus simple : ton staging, un compte de test, des données fictives.

Ce qu'on observe

  • Les requêtes et réponses de la session autorisée
  • Uniquement les parcours que tu choisis de montrer
  • Rien d'autre, et rien avant ta signature

Ce qu'on ne touche jamais

  • Ton code source et ton repo
  • Ta base de données
  • Ton infra et tes serveurs

Cadre légal

Interopérabilité uniquement, sur une API qui t'appartient ou que tu es autorisé à intégrer. Jamais de code source.

Autorisation d'abord

Un accord écrit signé avant la moindre capture. Ta protection autant que la nôtre.

Secrets masqués

Tokens, identifiants et données personnelles retirés avant toute analyse par un modèle.

Un prix fixe. Pas de surprise.

On valide le périmètre pendant l'appel, tu repars avec un devis ferme.

Envie de voir avant d'appeler ? L'outil gratuit compile ton HAR en local, en quelques secondes. · Le compilateur est open-source

Spec seule

Pour documenter l'existant et onboarder tes devs.

1 500€

  • Spec OpenAPI complète
  • Rapport de confiance
  • Livraison en 48 h
Réserver l'appel
Recommandé

Spec + SDK

Pour qu'une app ou un nouveau dev s'y branche tout de suite.

2 500€

  • Tout le pack Spec seule
  • Client TypeScript typé
  • Client Python typé
  • Exemples d'appels
Réserver l'appel

Spec + SDK + intégration

Pour qu'on fasse le branchement avec ton équipe.

dès3 000€

  • Tout le pack Spec + SDK
  • Branchement dans ton app
  • Session de passation
Réserver l'appel

Pas sûr du bon pack ? On tranche ensemble pendant l'appel.

Les questions qu'un CTO pose avant de signer.

C'est légal ?

Le cadre est fait pour : on documente l'interface d'une API qui t'appartient, ou que ton contrat t'autorise à intégrer, à partir de sessions que tu as le droit d'observer. Aucun contournement de protection, aucun accès au code source, et un accord écrit signé avant toute capture. Un doute sur tes droits ? On le tranche pendant l'appel, avant le moindre devis.

Mes données sont-elles exposées ?

Le plus sûr, et ce qu'on recommande : ton staging, un compte de test, des données fictives. Rien de réel ne sort. Si tu passes par la prod, tokens, identifiants et données personnelles sont masqués avant toute analyse par un modèle, et le rapport liste tout ce qui l'a été.

48 h, vraiment ?

48 h ouvrées, à compter de l'accord signé et de la session reçue. C'est le bon ordre de grandeur pour la plupart des API internes. Si la tienne est plus vaste, on te le dit pendant l'appel et le devis l'écrit noir sur blanc.

Qu'est-ce que je dois fournir ?

Trois choses : l'accord d'autorisation signé (on t'envoie le modèle), une session qui parcourt les écrans clés de ton appli, en export HAR ou via un compte de test, et vingt minutes pour nous dire ce qui compte. C'est tout.

Et un endpoint absent de la session ?

Il n'apparaît pas dans la spec : on ne devine pas. Le rapport de confiance liste ce qui a été vu, combien de fois, et ce qui reste à couvrir. Une session complémentaire suffit à combler les trous.

Pourquoi ne pas simplement lire le code ?

Parce que tu n'as pas à ouvrir ton repo à un prestataire. Et parce que la session montre ce que ton API fait vraiment, pas ce que le code était censé faire.

Que se passe-t-il pendant l'appel ?

Tu décris l'API qui te bloque. On évalue le périmètre avec toi et on te dit si c'est faisable. Si oui, tu repars avec un devis ferme. L'appel est offert et ne t'engage à rien. Réserver les 20 min

Dis-nous quelle API te bloque.

Vingt minutes. Si c'est faisable, tu repars avec un devis ferme. Sinon, tu sais pourquoi.

Réserver l'appel de cadrage.

20 minutes en visio. Dis-nous quelle API te bloque et tes disponibilités : David Amor te propose un créneau sous un jour ouvré, devis ferme à la fin de l'appel.

Ta demande arrive directement chez David Amor. Rien n'est transmis à un tiers.