Project anlegen
Production und Staging werden getrennt. Control Plane und Selbstregistrierung sind lokal als Demo umgesetzt; Provider- und Produktionsfreigabe stehen noch aus.
REST API · Vertragsstand 0.1.0-draft
Eine Schnittstelle für jedes Produkt.
qfinder nutzt JSON-POST-Routen, Bearer-Credentials mit Scopes und serverseitig gebundenen Tenantkontext. Die öffentliche Dokumentation bleibt bis zur v1-Freigabe als Draft gekennzeichnet.
Endpunkte
Der aktuelle Datenvertrag.
| Methode | Pfad | Fähigkeit |
|---|---|---|
| POST | /v1/geocode | Adresse in Kandidaten auflösen |
| POST | /v1/reverse | Koordinaten in Kandidaten auflösen |
| POST | /v1/autocomplete/sessions | Kurzlebige Suchsession anlegen |
| POST | /v1/autocomplete | Adressvorschläge suchen |
| GET | /version | Vertrag und Datasetstand lesen |
POST /v1/geocode
Authorization: Bearer <project-credential>
Content-Type: application/json
{
"query": "Pariser Platz 1, Berlin",
"countryCodes": ["DE"]
}
Authorization: Bearer <project-credential>
Content-Type: application/json
{
"query": "Pariser Platz 1, Berlin",
"countryCodes": ["DE"]
}
Integration
Der sichere Startpfad.
Scopes wählen
Nur benötigte Fähigkeiten aktivieren, zum Beispiel geocode:use und autocomplete:use.
Serverseitig aufrufen
Timeouts, validierte Eingaben, begrenzte Retries und manuellen Fallback im Consumer umsetzen.
Die vollständige OpenAPI-Datei bleibt derzeit im Produktrepository, bis Vertragsversion, Supportprozess und externe Dokumentationsfreigabe abgeschlossen sind.