Changelog

L'API v2 est actuellement en Beta (stable et utilisable en production). Toutes les versions de l'API Stream Estate figurent ci-dessous, dans l'ordre antéchronologique. Les changements incompatibles sont annoncés à l'avance et accompagnés d'une période de cohabitation v1 / v2.

Juin 2026 — Serveur MCP

Added

• Serveur MCP à https://api-v2.stream.estate/mcp (transport HTTP, authentification X-API-KEY). Permet à un assistant IA d'interroger l'API en langage naturel — voir le guide MCP.
• Ventilation byChannel dans GET /account/api-usage pour distinguer les appels DIRECT des appels passés via MCP.

Mai 2026 — Webhooks signés HMAC

Added

• Webhook signing via header X-Webhook-Signature: sha256=... et X-Webhook-Timestamp pour la protection replay. Détails complets dans le guide webhooks.
• Endpoint POST /account/webhook-signing-key/rotate pour renouveler la clé sans interrompre les livraisons en vol.
• Header User-Agent: StreamEstate-Webhook/1.0 sur toutes les requêtes sortantes.

Changed

• Les destinations webhook créées avant cette release reçoivent la clé via la réponse de leur premier rotate.

Mai 2026 — API v2

Breaking

• Domaine v2 : api-v2.stream.estate remplace api.stream.estate (la v1 reste accessible pendant 12 mois).
• Tous les payloads passent en JSON:API (application/vnd.api+json) — voir migration v1 → v2.
• POST /properties consolide search + filter dans un seul endpoint avec arbre criteria récursif.

Added

• Endpoint /analytics/listings pour les métriques warehouse agrégées.
• Pagination cursor sur /properties en complément de la pagination par page.
• Quota par IP à 100 req/min sur les endpoints publics (voir rate limits).

Deprecated

• GET /properties?q=... et tous les query-params plats. Utilisez POST /properties avec criteria à la place.