Documentation pour développeurs

Intégrer le calculateur

L'option la plus simple — insérez notre calculateur dans votre page sous forme d'iframe. Nous offrons une version épurée (sans en-tête ni pied de page INTEGRIS) à l'adresse /calculatorSkinny : elle s'intègre proprement dans n'importe quelle mise en page.

Aperçu en direct — il s'agit de l'intégration réelle

<iframe
  src="https://www.integris-mgt.com/calculatorSkinny"
  width="100%"
  height="700"
  title="INTEGRIS PPP Calculator"
  loading="lazy"
  style="border: 0;"
></iframe>

Une hauteur d'environ 700 px convient à la plupart des mises en page. Le calculateur est adaptatif — accordez-lui toute la largeur dont vous disposez.

Variante RRI

Ajoutez ?plan=ipp pour afficher l'intégration aux couleurs du RRI. La légende indique « RRI » au lieu de « PPP® », le curseur d'âge est limité à 40 ans et plus, et le panneau de statistiques affiche « Votre avantage RRI ».

<iframe
  src="https://www.integris-mgt.com/calculatorSkinny?plan=ipp"
  width="100%"
  height="700"
  title="INTEGRIS IPP Calculator"
  loading="lazy"
  style="border: 0;"
></iframe>

Masquer notre appel à l'action

Par défaut, le calculateur affiche sous le résultat un bouton INTEGRIS « Obtenir mon illustration personnalisée ». Si vous préférez intégrer votre propre appel à l'action, ajoutez ?cta=off pour le masquer — les curseurs, le graphique et les statistiques du résultat demeurent identiques.

<iframe
  src="https://www.integris-mgt.com/calculatorSkinny?cta=off"
  width="100%"
  height="700"
  title="INTEGRIS PPP Calculator"
  loading="lazy"
  style="border: 0;"
></iframe>

Les paramètres se combinent — par exemple, ?plan=ipp&cta=off affiche l'intégration RRI sans l'appel à l'action INTEGRIS.

Créer votre propre interface avec notre API

Si vous souhaitez maîtriser entièrement l'apparence, appelez directement notre point de terminaison de projection et affichez les chiffres comme bon vous semble : votre propre bibliothèque de graphiques, un tableau, une mise en page sur mesure.

Point de terminaison

POST https://www.integris-mgt.com/api/calculators/pppvsrsp
Content-Type: application/json

Corps de la requête

Les quatre champs sont obligatoires et doivent être numériques. Les valeurs hors intervalle sont silencieusement ramenées aux bornes plutôt que rejetées : l'API ne refuse donc jamais une requête d'apparence valide — reproduisez ces bornes dans votre propre interface si vous souhaitez offrir une expérience utilisateur soignée.

Champ	Intervalle (bornes incluses)	Notes
`age`	`19 – 65`	Âge du participant, en années
`yearsOfService`	`0 – 50`	Années d'emploi T4 antérieures à racheter
`currentSalary`	`70000 – 500000`	Salaire annuel en dollars (et non en milliers de dollars)
`averagePastSalary`	`0 – 500000`	Revenu T4 moyen des années de service antérieures

Réponse

La réponse compte toujours 53 lignes annuelles à partir de l'âge saisi. La plupart des intégrateurs souhaitent tronquer à la fin naturelle du décaissement — la première ligne après le sommet où sPPP atteint 0 — pour que le graphique se termine proprement à la retraite au lieu de s'étirer sur une série de zéros. Retenez la fenêtre qui convient à votre mise en page.

{
  "sStatus": "success",
  "sLabels": ["45 years", "46 years", "47 years", "48 years", "...", "97 years"],
  "sPPP":   [0,           5234,        11421,       18587,      // 53 entries
             /* … */],
  "sRRSP":  [0,           4218,         9106,       14751,
             /* … */]
}

sLabels — 53 chaînes indiquant l'âge, à partir de l'âge saisi ("{n} years").
sPPP — total projeté dans le régime de retraite à chacun de ces âges, en dollars.
sRRSP — total projeté dans un REER équivalent à chacun de ces âges, à des fins de comparaison.

Réponses d'erreur

400 — il manque un champ obligatoire dans le corps de la requête, ou l'une des valeurs n'est pas numérique. Les valeurs numériques hors intervalle ne renvoient pas de 400; elles sont ramenées aux bornes silencieusement.
405 — la méthode de la requête n'est pas POST.
500 — erreur du moteur de calcul. Ne devrait pas se produire en utilisation normale; écrivez-nous si vous en rencontrez une.

Exemple — curl

curl -X POST https://www.integris-mgt.com/api/calculators/pppvsrsp \
  -H "Content-Type: application/json" \
  -d '{"age":45,"yearsOfService":0,"currentSalary":120000,"averagePastSalary":0}'

Exemple — JavaScript

const res = await fetch('https://www.integris-mgt.com/api/calculators/pppvsrsp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    age: 45,                  // 19–65, integer
    yearsOfService: 0,        // 0–50, integer
    currentSalary: 120000,    // 70000–500000, dollars (not $1000s)
    averagePastSalary: 0,     // 0–500000, dollars
  }),
});

const { sLabels, sPPP, sRRSP } = await res.json();
// 53 yearly rows starting at the input age. Slice the window you want
// (e.g. the next 25 years of accumulation) and feed it into your chart.

Limites de débit et mise en cache

Mettez en cache sans retenue.Les réponses sont entièrement déterministes — le même tuple d'entrée (age, yearsOfService, currentSalary, averagePastSalary) renvoie toujours les mêmes 53 lignes. Si vous appelez l'API depuis la boucle d'appel d'outils d'un LLM, mettez en cache selon une empreinte de ces quatre valeurs; il n'est presque jamais nécessaire d'appeler deux fois pour les mêmes entrées.

Plafond indicatif : environ 10 requêtes/seconde par intégration.Aucun quota strict pour l'instant, mais limitez les rafales simultanées afin que les utilisateurs réels ne subissent pas un démarrage à froid pendant l'exécution de votre traitement par lots. Nous publierons une véritable réponse 429 si cela devient un problème.

Le démarrage à froid prend environ 13 secondes, contre environ 400 ms pour un appel à chaud. La fonction conserve son moteur de formules en mémoire entre les requêtes : le premier appel après une période d'inactivité ou après un déploiement peut donc accuser un léger délai. Considérez un premier appel lent comme normal, et non comme un échec.

Prévoyez une temporisation en cas d'erreur 5xx.Exponentielle, 3 nouvelles tentatives au maximum. Nous préchauffons la fonction durant les heures ouvrables en semaine, mais des erreurs transitoires demeurent possibles.

Aucun renseignement personnel.Les quatre entrées sont des nombres scalaires — n'envoyez jamais de noms, de courriels, de numéros de compte ni quoi que ce soit qui pourrait identifier une personne réelle.