Plattform
Orinverse API (Entwurf)
Orinverse ist eine koordinatenbasierte Datenebene. Dieser Abschnitt beschreibt das minimale API-Set zum Erstellen und Lesen von Punkten.
Dieser Abschnitt ist ein Entwurf. URLs, Authentifizierung und
Response-Formate müssen vor der Umsetzung bestätigt werden.
Punkt-Datenmodell
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | Eindeutige Kennung des Punkts. |
lat |
number | Breitengrad (Pflichtfeld). |
lon |
number | Längengrad (Pflichtfeld). |
title |
string | Kurzbezeichnung des Punkts. |
payload |
object | Beliebige Daten (Nachricht, Metadaten, Links). |
tags |
string[] | Tags für Filter und Gruppierung. |
anchorTx |
string | Optionale ORIN-Transaktion zur Verankerung. |
createdAt |
string | ISO-Zeitstempel der Erstellung. |
updatedAt |
string | ISO-Zeitstempel des letzten Updates. |
Punkt erstellen
POST /api/v1/points
{
"lat": 55.751244,
"lon": 37.618423,
"title": "Beispielpunkt",
"payload": {
"text": "Beispiel-Orinverse-Eintrag",
"link": "https://orinverse.cash"
},
"tags": ["info", "community"]
}Antworten sollten die neue id und optional anchorTx zurückgeben.
Punkte lesen und suchen
- GET
/api/v1/points/{id}— einzelnen Punkt abrufen. - GET
/api/v1/points?bbox=lat1,lon1,lat2,lon2— Suche per Bounding Box. - GET
/api/v1/points?tags=community,news— Filter nach Tags.
Aktualisieren und löschen
- PATCH
/api/v1/points/{id}— partielle Aktualisierung. - DELETE
/api/v1/points/{id}— entfernen oder unpublishen.
ORIN-Ankerung
Beim Veröffentlichen von Punkten empfiehlt sich die Verankerung des
Payload-Hashes in ORIN. Orinverse sollte anchorTx und
Bestätigungsdaten zurückgeben, sobald verfügbar.