Sandbox API — Vorrei Menu

Cos’è la Sandbox

È un sottodominio separato, con dati fittizi ma realistici. Perfetto per collegare il tuo registratore o gestionale senza toccare i dati reali.

Dati di esempio aggiornati ogni giorno
Stesso schema della V2 in produzione
Stesse regole di autenticazione

Disponibile

Rate limit: 60 req/min Window: 1 min

Quickstart

In 2 minuti testi la tua integrazione.

Endpoint

GET https://sandbox.vorreimenu.it/api_v2.php

Auth ?key=LA_TUA_CHIAVE oppure Authorization: Bearer …

Versione Accept: application/vnd.vorrei.v2+json

Parametri limit, cursor, date_from, date_to

Se manca l’header Accept, la sandbox risponde comunque con il payload V2.

cURL

curl -s "https://sandbox.vorreimenu.it/api_v2.php?limit=50&cursor=0" \
  -H "Authorization: Bearer LA_TUA_CHIAVE" \
  -H "Accept: application/vnd.vorrei.v2+json"

Usa cursor come ultimo ordine_id processato per paginare senza duplicati.

JavaScript

fetch('https://sandbox.vorreimenu.it/api_v2.php?limit=50&cursor=0', {
  headers: {
    'Authorization': 'Bearer LA_TUA_CHIAVE',
    'Accept': 'application/vnd.vorrei.v2+json'
  }
}).then(r => r.json()).then(console.log);

PHP

<?php
$ch = curl_init('https://sandbox.vorreimenu.it/api_v2.php?limit=50&cursor=0');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'Authorization: Bearer LA_TUA_CHIAVE',
  'Accept: application/vnd.vorrei.v2+json'
));
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data);

Test rapido

Richiama l’endpoint con la tua chiave
Leggi articoli[] e compila lo scontrino
Rispetta cursor/limit per scorrere gli ordini

Schema risposta (V2 · Sandbox)

Solo campi utili a registratori/gestionali + recap cliente.

Esempio JSON

{
  "version": "v2",
  "request_id": "req_...",
  "meta": { "count": 1, "limit": 50, "next_cursor": "410" },
  "data": [
    {
      "ordine_id": "409",
      "numero_ordine": "VRM-409",
      "data": "2025-10-31",
      "ora": "10:20",
      "canale": "consegna",                        // ritiro | consegna | tavolo
      "posizione_servizio": "",                     // Tavolo/Ombrellone/Camera se presente
      "km_consegna": 201,                           // opzionale
      "articoli": [
        { "titolo": "3333", "qta": 10, "prezzo_unitario": 2, "totale": 20, "reparto": "PIZZERIA", "iva": null }
      ],
      "totale": 22,                                 // totale ordine
      "pagamento": "Alla consegna",                 // contanti | POS | online...
      "note_preparazione": "",
      "note_consegna": "",
      "cliente": {
        "nome": "fabio pucci",
        "telefono": "3513048018",
        "email": "andromeda78ita@gmail.com",
        "indirizzo": "Via dei Cimatori, 80",
        "citta": "Roma",
        "cap": "00186",
        "provincia": "RM",
        "presso": "nomesocieta"
      }
    }
  ]
}

Se non hai la mappa IVA, lascia iva a null e gestiscila lato gestionale.

Campi principali

ordine_id, numero_ordine
data, ora, canale
posizione_servizio, km_consegna (se consegna)
articoli[] { titolo, qta, prezzo_unitario, totale, reparto?, iva? }
totale, pagamento, note_preparazione, note_consegna
cliente { nome, telefono, email, indirizzo, citta, cap, provincia, presso? }

Paginazione: cursor = ultimo ordine_id

Autenticazione

Query string: ?key=LA_TUA_CHIAVE

Oppure header: Authorization: Bearer LA_TUA_CHIAVE

Le chiavi della sandbox sono indipendenti dall’ambiente produzione.

Filtri & limiti

limit — default 100, max 200
cursor — ultimo ordine_id letto
date_from / date_to — filtro per data servizio (YYYY-MM-DD)
Rate limit: 60 richieste/minuto

Errori standard

401 {"error":"unauthorized","message":"Chiave API non valida o mancante"}
403 {"error":"forbidden","message":"Accesso non autorizzato"}
429 {"error":"rate_limited","message":"Troppi tentativi"}
500 {"error":"server_error","message":"DB connection error"}

Usa i codici HTTP per gestire gli stati nel tuo adattatore.

Pronto a collegarti?

Apri subito la sandbox, prendi la chiave e prova il tuo flusso.

Vai alla Sandbox Serve aiuto? Scrivici

Prova le API in un ambiente sicuro