Suede
Auf dieser Seite

Sofortantworten

Zuletzt aktualisiert

Berechnen Sie eine Sofortantwort — Rechner, Einheiten- und Währungsumrechnung, Weltzeit, Wörterbuchdefinitionen, Hashes, QR-Codes und über zwei Dutzend weitere Familien — vollständig auf Suede: keine Upstream-Aufrufe, die Frage erreicht nie einen Dritten.

Code
GET /v1/answers?q=100+usd+in+euro
Authorization: Bearer suede_live_…

In der Mitgliedschaft enthalten (Standard): Aufrufe erscheinen in /v1/usage unter requests mit 0 billable_units und verbrauchen keine Credits. (Die Plattform kann auf Abrechnung umstellen — 1 Einheit pro Aufruf wie bei der Suche; dann gelten die X-Credits-*-Header und insufficient_credits.)

Parameter

Param Pflicht Bedeutung
q ja Die Frage. Bis zu 512 Zeichen.
hl nein Die Parse-Sprache: en, ar, de, es, fr, ja. Unbekannte Werte fallen auf en zurück. 12 fuß in meter parst unter hl=de; Zahlformate folgen der Sprache (3,5 km ist dreieinhalb).
gl nein Regions-Bias für regionsabhängige Antworten.

Die Antwort

answered: false (mit HTTP 200) ist das übliche, erfolgreiche Ergebnis — die meisten Anfragen sind Websuchen. Bei answered: true enthält answer:

  • kind — die Familie (calculator, currency, time_zone, definitions, …). Neue Arten können ohne Versionssprung hinzukommen: unbekannte Arten defensiv als generische Karte behandeln.
  • primary, expression, secondary, items[] — der Karteninhalt, invariant formatiert.
  • Stabile Bezeichner — primary_label, items[].label, disclosure.key (und primary bei primary_is_key: true) sind stabile maschinenlesbare answers.*-Bezeichner: nie umbenannt, neue können hinzukommen.
  • copy_text — die Maschinenform (nackte Zahl, ISO-Zeitpunkt, Digest); null ⇒ primary verwenden.
  • svg — Inline-SVG für visuelle Arten (QR, Farbfeld). Als nicht vertrauenswürdiges Bild einbetten.
  • is_error — eine Fehler-KARTE (Division durch null): beantwortet, mit Diagnose in primary_label (answers.err.*).
  • timezone — das Weltuhr-Modell für kind: time_zone: Zeilen je Ort (Zone, Ortszeit/-datum, UTC-Offset, Sommerzeit, Tag/Nacht, Datumsversatz, nächste Umstellung) plus ein 24-Zeichen- meeting_strip pro Zeile (n Nacht, d Tag, b Geschäftszeiten).
  • definitions — das Wörterbuchmodell für kind: definitions: Stichwort, IPA, Bedeutungen nach Wortart, dazu source_url + license (CC BY-SA 4.0 — beim Anzeigen die Quelle nennen oder verlinken). Arabische Einträge tragen derzeit englische Definitionen (gloss_lang: "en").

Wissenswert:

  • client_info beschreibt den API-Aufrufer — Ihren Server, nicht Ihren Endnutzer.
  • Währungen nutzen die EZB-Referenzkurse; disclosure trägt das Kursdatum. Nur zur Information.
  • Timer sind ein Web-Widget und antworten nie über die API.

Es gelten die üblichen Rate-Limits. Das vollständige Schema steht im OpenAPI-Dokument.

War diese Seite hilfreich?