API pubblica di Recipok e token di accesso

Name: API pubblica di Recipok e token di accesso
Uploaded: 2026-10-17
Description: Come creare e revocare i token dell’API, quali dati si possono leggere e scrivere e dove si trova la documentazione per il tuo tecnico informatico.

Piano Integrale

Come creare e revocare i token dell’API, quali dati si possono leggere e scrivere e dove si trova la documentazione per il tuo tecnico informatico.

A cosa serve

L’API pubblica è la porta che permette a un altro programma di leggere e scrivere nel tuo account Recipok senza che nessuno copi i dati a mano: il tuo negozio online che crea ordini, il tuo gestionale che raccoglie i DDT, un foglio di calcolo che consulta il magazzino ogni mattina.

Ogni programma entra con un token, una chiave lunga che crei tu, consegni a chi realizza il collegamento e puoi revocare quando vuoi. Questo articolo è per il titolare che deve creare quella chiave e per il tecnico informatico che la userà.

Prima di iniziare

I token fanno parte del piano Integrale.
Li crea un utente con ruolo di responsabile o amministratore.
Ti serve qualcuno che programmi il collegamento: chi ti segue il gestionale o il tuo tecnico informatico. Se non ce l’hai, consulta Collega Recipok alla tua fatturazione, contabilità o cassa: realizziamo anche integrazioni su misura.

Dove si trova

Nel menu del tuo account, in alto a destra, entra in Integrazioni e apri la scheda API Token. La schermata Opzioni sviluppatore mostra le stesse informazioni; con un piano diverso dall’Integrale descrive soltanto l’API e avvisa che il tuo piano non crea token.

Integrazioni › API Token

Reciplus ERPDobboxHoldedAPI Token

Integrazione API

1URL base dell’API: https://api.recipok.com · Intestazione di autenticazione · Esempio di richiesta

Visualizza la documentazione API completa

I tuoi token

Nome	Stato
Negozio online	Conservato in modo sicuro	2Elimina

Crea un nuovo token

Nome del token: Ad esempio: integrazione Zapier, sviluppo locale, ecc.

3Genera token

La scheda API Token di Pastelería La Plaza, con un token creato per il suo negozio online.

1I dati per il tuo tecnico: l’indirizzo dell’API, l’intestazione in cui va il token e un esempio pronto da copiare.
2Ogni token ha un nome: così sai quale programma lo usa e quale eliminare.
3Genera token crea la chiave e te la mostra una sola volta.

Creare un token

Dagli un nome

In Crea un nuovo token, scrivi in Nome del token a cosa serve: «Negozio online», «Commercialista», «Prove del tecnico». Un token per programma.

Premi Genera token

Compare l’avviso Copia questo token adesso. Premi Copia e conservalo in un luogo sicuro oppure invialo direttamente a chi realizzerà il collegamento.

Conferma

Quando premi Conferma il token viene nascosto per sempre. Nell’elenco resta come «Conservato in modo sicuro»: Recipok lo salva cifrato e nessuno può più leggerlo.

AttenzioneSe chiudi senza copiarlo, non succede niente di grave: eliminalo e generane un altro.

Revocare i token

Per ritirare una chiave, eliminala da I tuoi token con Elimina. Il programma che la usava smette subito di accedere.
L’amministratore vede inoltre Token di altri utenti, con il loro proprietario, e può usare Revoca token su qualsiasi di essi. Utile quando qualcuno lascia l’azienda.

Importante

Un token dà accesso ai dati della tua azienda. Non incollarlo in email inviate a più persone né in documenti condivisi, e creane uno diverso per ogni programma: così puoi bloccarne uno senza fermare gli altri.

Cosa può fare un programma con l’API

Area	Esempi
Ricette	Consultare le ricette con ingredienti, formati, prezzi e IVA e valori nutrizionali.
Ingredienti e fornitori	Leggere e inserire ingredienti; consultare i fornitori.
Acquisti e magazzino	Registrare le entrate merce e consultare o rettificare il magazzino.
Produzione	Creare ordini di produzione, assegnare lotti e completarli.
Vendite	Creare ordini di vendita, segnarli come consegnati, registrare uscite con i loro lotti e consultare o creare clienti.
HACCP	Inserire e consultare registrazioni HACCP e ubicazioni.

Per il tuo tecnico informatico

La documentazione tecnica completa si trova su api.recipok.com/api/doc (pulsante Visualizza la documentazione API completa). Si può leggere in diverse lingue.
L’API risponde sul proprio dominio: le richieste inviate all’indirizzo con cui accedi a Recipok non le arrivano.
Il token va nell’intestazione di autenticazione indicata dalla schermata, in ogni richiesta.
Unità imperiali, facoltative. Se l’integrazione lavora in libbre, once o gradi Fahrenheit, può richiederlo con l’intestazione X-Unit-System: imperial_uk, us_customary, account (le unità configurate nel tuo account) o metric. Senza quell’intestazione tutto resta nel sistema metrico, come sempre.

Consiglio

Prima di collegare un nuovo programma al tuo account reale, chiedi al tuo tecnico di fare una prova con pochi dati e controlla in Recipok ciò che ha creato. I dubbi sull’API si risolvono nella chat di assistenza.

Domande frequenti

Ho perso il token: posso rivederlo?

No. Per sicurezza il token viene mostrato una sola volta, quando lo crei. Se non l’hai copiato, eliminalo e generane uno nuovo; poi cambia la chiave nel programma che lo usava.

Cosa succede se revoco un token?

Qualsiasi programma che chiama l’API con quel token smette subito di funzionare. È ciò che devi fare se smetti di lavorare con un fornitore o sospetti che la chiave sia circolata.

Perché non vedo la scheda API Token?

I token API fanno parte del piano Integrale, e la schermata la vedono solo il responsabile e l’amministratore. Con un altro piano, Opzioni sviluppatore ti mostra com’è l’API, ma non crea token.

L’API mi restituisce libbre e once?

Solo se la tua integrazione lo chiede espressamente. Senza indicarlo, l’API risponde sempre in grammi, chili, litri e gradi Celsius, quindi i collegamenti che già funzionano non cambiano.