Waafir
Cette page est une traduction automatique en attente de relecture humaine. Elle peut contenir des erreurs.

Recettes

Ce recueil de recettes s'adresse aux ingénieurs de fintech qui connectent leur portefeuille de prêts à l'API de suivi de Waafir. Chaque recette traite une tâche de bout en bout avec les trois clients de référence — cURL, TypeScript, Python — afin que le lecteur n'ait pas à transposer mentalement d'un langage à l'autre. Les recettes privilégient les chemins d'échec et les cas limites qu'une intégration réelle rencontre, et pas seulement le scénario nominal.

À qui s'adresse ce recueil

L'administrateur de votre organisation Waafir vous a délivré un jeton d'accès personnel (PAT), et vous écrivez le code qui soumet vos données quotidiennes de loan tape — emprunteurs, prêts, échéances de remboursement prévues, paiements effectifs, sûretés et évaluations des sûretés — à Waafir. Chaque soumission est enregistrée telle qu'envoyée, puis stockée sous forme de lignes ; elle alimente ensuite l'onglet de suivi des investisseurs de toute salle de données liée au portefeuille.

Comment utiliser ces recettes

Chaque recette suit la même structure : une courte introduction, trois blocs de code délimités dans un ordre fixe et un bref paragraphe de vérification. Les blocs de code sont :

  1. cURL — à copier-coller dans votre shell. Le moins prescriptif ; utile pour des sondages ponctuels et des vérifications en CI.
  2. TypeScript — basé sur fetch, s'appuyant sur les contrats JSON publics. Aucune installation de SDK requise.
  3. Python — basé sur requests, s'appuyant sur les mêmes contrats JSON. La bibliothèque standard suffit ; aucun paquet spécifique à Waafir n'est requis.

Authentification

Tous les endpoints exigent un PAT dans l'en-tête Authorization :

Authorization: Bearer <YOUR_PAT>

Un PAT est limité à une seule organisation Waafir et porte l'identité de cette organisation à chaque requête. Traitez-le comme un secret ; renouvelez-le depuis le tableau de bord en cas de fuite. L'URL de base de l'API utilisée dans ces recettes est https://app.waafir.io — remplacez-la par votre URL de préproduction si vous intégrez d'abord avec le tenant sandbox.

Conventions utilisées dans les recettes

  • Toutes les variables shell des exemples cURL sont écrites sous la forme ${UPPER_CASE_NAME}, afin que vous puissiez les export une seule fois et les réutiliser d'une recette à l'autre.
  • Les exemples TypeScript et Python supposent que BASE_URL et PAT sont lus depuis l'environnement. Adaptez-les à votre chargeur de configuration.
  • L'en-tête Idempotency-Key est la convention commune à toute la plateforme pour des relances sûres ; consultez la recette sur les relances pour la sémantique précise.
  • Tous les endpoints d'écriture acceptent vos propres valeurs external_id — les identifiants fournis par l'appelant restent la référence canonique tout au long de l'ingestion, du rapprochement et des téléchargements de tape. Vous n'avez jamais besoin de connaître les UUID internes de Waafir.

Ce que ce recueil ne couvre pas

Ce recueil est orienté tâches. Pour les définitions exhaustives des endpoints, les schémas de requête et de réponse et les références des codes d'erreur, consultez la section de référence de l'API dès sa publication aux côtés de ce recueil. Pour les concepts produit, comme ce qu'est un portefeuille et son lien avec une salle de données, consultez Salles de données et la section des concepts fondamentaux.

Les recettes

  1. Importer en masse un loan tape via NDJSON asynchrone — le flux d'ingestion de base : téléversement direct, validation, interrogation jusqu'à la fin du traitement.
  2. Valider un chargement à blanc avant de valider les données — le même flux avec ?dryRun=true ; découvrez ce que contient votre fichier avant qu'aucune ligne ne soit écrite.
  3. Relancer en toute sécurité avec une clé d'idempotence — résistez aux défaillances réseau passagères sans créer d'imports en double.
  4. Inspecter les erreurs d'échec partiel après un import — parcourez page par page les erreurs ligne par ligne lorsqu'un import se termine en partial.
  5. Annuler un import en cours — arrêtez un import de longue durée à la prochaine limite de lot, sans lignes partiellement écrites.
  6. Rapprocher vos données par identifiant externe — confirmez qu'une ligne a bien été enregistrée, à l'aide de votre propre identifiant, et vérifiez les décomptes quotidiens.