Plateforme

API Orinverse (brouillon)

Orinverse est une couche de données basée sur des coordonnées. Cette section décrit l'API minimale pour créer et lire des points.

Cette section est un brouillon. Les URLs, l'authentification et les formats de réponse doivent être validés avant implémentation.

Modèle de données d'un point

Champ	Type	Description
`id`	string	Identifiant unique du point.
`lat`	number	Latitude (obligatoire).
`lon`	number	Longitude (obligatoire).
`title`	string	Titre court du point.
`payload`	object	Données personnalisées (message, métadonnées, liens).
`tags`	string[]	Tags pour filtrer et regrouper.
`anchorTx`	string	Transaction ORIN optionnelle pour l'ancrage.
`createdAt`	string	Horodatage ISO de création.
`updatedAt`	string	Horodatage ISO de mise à jour.

Créer un point

POST /api/v1/points

{
  "lat": 55.751244,
  "lon": 37.618423,
  "title": "Point exemple",
  "payload": {
    "text": "Entrée Orinverse",
    "link": "https://orinverse.cash"
  },
  "tags": ["info", "community"]
}

La réponse doit retourner la id et, si disponible, anchorTx.

Lire et rechercher des points

GET /api/v1/points/{id} — récupérer un point.
GET /api/v1/points?bbox=lat1,lon1,lat2,lon2 — recherche par zone.
GET /api/v1/points?tags=community,news — filtrage par tags.

Mettre à jour et supprimer

PATCH /api/v1/points/{id} — mise à jour partielle.
DELETE /api/v1/points/{id} — supprimer ou dépublier.

Ancrage ORIN

Lors de la publication de points, il est recommandé d'ancrer le hash dans ORIN. Orinverse devrait retourner anchorTx et les confirmations quand disponibles.