Réponses instantanées

Calculez une réponse instantanée — calculatrice, conversion d'unités et de devises, heure mondiale, définitions de dictionnaire, hachages, codes QR et plus de deux douzaines d'autres familles — entièrement sur Suede : aucun appel amont, la question n'atteint jamais un tiers.

GET /v1/answers?q=100+usd+en+eur
Authorization: Bearer suede_live_…

Inclus dans l'adhésion par défaut : les appels apparaissent dans /v1/usage sous requests avec 0 billable_units et ne consomment aucun crédit. (La plateforme peut passer à la facturation — 1 unité par appel, comme la recherche ; les en-têtes X-Credits-* et insufficient_credits s'appliquent alors.)

Paramètres

La réponse

answered: false (avec HTTP 200) est l'issue courante et normale — la plupart des requêtes sont des recherches web. Quand answered est vrai, answer contient :

• kind — la famille (calculator, currency, time_zone, definitions, …). De nouvelles familles peuvent apparaître sans changement de version : traitez l'inconnu comme une carte générique.
• primary, expression, secondary, items[] — le contenu de la carte, format invariant.
• Identifiants stables — primary_label, items[].label, disclosure.key (et primary quand primary_is_key est vrai) sont des identifiants answers.* stables : jamais renommés, de nouveaux peuvent apparaître.
• copy_text — la forme machine (nombre nu, instant ISO, empreinte) ; null ⇒ utilisez primary.
• svg — SVG inline pour les familles visuelles (QR, pastille de couleur). À isoler comme une image non fiable.
• is_error — une CARTE d'erreur (division par zéro) : répondu, avec le diagnostic dans primary_label (answers.err.*).
• timezone — le modèle d'horloge mondiale pour kind: time_zone : lignes par lieu (zone, heure et date locales, décalage UTC, heure d'été, jour/nuit, décalage de date, prochain changement) plus un meeting_strip de 24 caractères (n nuit, d jour, b heures de bureau).
• definitions — le modèle de dictionnaire pour kind: definitions : mot-vedette, IPA, sens par nature grammaticale, avec source_url + license (CC BY-SA 4.0 — affichez ou liez la source quand vous montrez ce contenu). Les entrées arabes portent pour l'instant des définitions en anglais (gloss_lang: "en").

À savoir :

• client_info décrit l'appelant de l'API — votre serveur, pas votre utilisateur final.
• Les devises utilisent les taux de référence BCE ; disclosure porte la date du taux. Indicatif.
• Les minuteurs sont un widget web et ne répondent jamais via l'API.

Les limites de débit habituelles s'appliquent. Le schéma complet est dans le document OpenAPI.