Entra nella beta
Home / API per robot

API per far pubblicare i robot

Un robot connesso può aggiornare il proprio profilo da solo: a fine test, a ogni nuova versione del firmware o a intervalli regolari. Basta una richiesta HTTP con un token dedicato al robot.

Esempio: una POST JSON

Richiesta
POST https://api.social4robot.com/v1/robots/rb_7f3k2q/posts
Authorization: Bearer <TOKEN_DEL_ROBOT>
Content-Type: application/json

{
  "type": "log",
  "text": "Giro di test completato: 1,2 km in 14 minuti, nessun errore di navigazione.",
  "visibility": "public",
  "firmware": "v0.9.3",
  "telemetry": {
    "battery_v": 24.6,
    "distance_m": 1200,
    "motor_temp_c": 41.5,
    "errors": 0
  },
  "tags": ["ros2", "amr", "test-esterno"]
}
Risposta
HTTP/1.1 201 Created
{
  "id": "post_92hd71",
  "robot": "rb_7f3k2q",
  "url": "https://social4robot.com/r/rb_7f3k2q/post_92hd71",
  "created_at": "2026-11-02T10:24:00Z"
}

API in anteprima. Endpoint, campi e limiti mostrati sono indicativi e possono cambiare prima del rilascio stabile. Gli iscritti alla beta ricevono la documentazione aggiornata e le chiavi di test.

Campi principali

CampoTipoDescrizione
typestringalog, telemetry, release, media
textstringaTesto del post, mostrato sul profilo
visibilitystringapublic, collaborators o private
firmwarestringaVersione del firmware al momento del post
telemetryoggettoCoppie chiave-valore numeriche; solo i campi resi pubblici nel profilo vengono mostrati
tagsarrayEtichette per la ricerca

Sicurezza e buone pratiche

  • Un token per ogni robot, con permessi limitati alla pubblicazione su quel profilo e revocabile in qualsiasi momento
  • Non scrivere il token nel codice pubblicato: usa variabili d'ambiente o un file escluso dal repository
  • Usa HTTPS e verifica il certificato anche sui microcontrollori
  • Pubblica a intervalli ragionevoli: i limiti di frequenza vengono comunicati nella documentazione della beta
  • Non inviare posizione, immagini di persone o dati personali se non ti servono davvero

Esempi per piattaforma

ROS 2

Un nodo che legge un topic e pubblica periodicamente.

ESP32 e Arduino

Una funzione C++ da chiamare a fine ciclo.

Privacy e telemetria

Cosa pubblicare e cosa no.

Registra il tuo robot

Entra nella beta: è gratis durante l'accesso anticipato. Ti scriviamo quando si apre il tuo turno di accesso.

Entra nella beta

Domande frequenti

Serve un SDK?

No: è una normale API HTTP con JSON, utilizzabile da qualsiasi linguaggio. Esempi pronti per ROS 2 ed ESP32 sono in queste pagine.

Posso caricare video e immagini via API?

Sì, con un post di tipo media. Le modalità di caricamento e i limiti di dimensione sono nella documentazione della beta.

Cosa succede se il robot impazzisce e pubblica mille post?

I limiti di frequenza bloccano le raffiche e ti avvisiamo. Puoi revocare il token del robot con un clic, senza toccare il tuo account.

Registra il tuo robot, entra nella beta

Lasciaci i dati e il robot che vuoi registrare: apriamo gli accessi a gruppi e ti scriviamo quando tocca a te.

  • Gratis durante l'accesso anticipato
  • Chiavi API di test per far pubblicare il robot
  • Puoi cancellare account e dati quando vuoi
Entra nella beta