API
Catalogo, ordini e chiavi tramite interfaccia
Portate il nostro catalogo nel vostro sistema, avviate ordini e ritirate le chiavi. Questa pagina mostra il percorso in sei passaggi. Limiti, ambiente di prova e confini si trovano nella documentazione.
Funzionerà non appena il negozio aprirà. Fino ad allora potete leggere tutto con calma.
Pagina per sviluppatori
OpenAPI
Ogni chiamata è descritta in un file OpenAPI 3.1. Ogni numero nelle pagine è il numero che il codice applica.
- BearerUna chiave per applicazione, salvata solo come hash, con scadenza e rotazione
- JSONImporti in centesimi interi, date in ISO 8601, nomi in snake_case
- 120 al minutoletture per una nuova chiave, 600 quando ha 7 giorni
- FirmatoWebhook con firma, su richiesta anche chiamate firmate (RFC 9421)
L'API è sviluppata e testata, la documentazione è online. Le chiavi si potranno creare non appena il negozio aprirà. Non ancora disponibili e solo pianificati: un kit software già pronto, un credito prepagato.
Cosa potete farci
Sincronizzare il catalogo
Caricate l'intero elenco una volta, poi solo ciò che è cambiato dalla vostra ultima sincronizzazione. Una vista leggera mostra solo la disponibilità.
Pronta, si apre con l'avvio delle venditeAvviare ordini
Un ordine per chiamata, con limite di prezzo, il vostro numero e una chiave contro gli acquisti doppi.
Pronta, si apre con l'avvio delle venditeRitirare le chiavi
Con un diritto dedicato, contate e registrate. La prima richiesta pone fine al diritto di recesso di quell'ordine.
Pronta, si apre con l'avvio delle venditeRicevere webhook
Chiamate firmate al vostro server quando cambia un ordine o un prodotto. Fino a 3 indirizzi.
Pronta, si apre con l'avvio delle venditeOffrire come venditore
Gestite offerte, prezzi e disponibilità dal vostro sistema di magazzino. Presuppone che la vendita su Capydra sia aperta.
Pronta, si apre con l'avvio delle venditeUsare con assistenti IA
Lo stesso account funziona tramite il nostro server MCP. Le regole e i limiti sono gli stessi.
Pronta, si apre con l'avvio delle vendite
Sei passaggi fino alla prima chiamata
- 1
Creare un account
Vi registrate nel negozio.
- 2
Creare una chiave
Sotto «Chiavi API»: un nome, il ruolo (acquirente o venditore) e i diritti che vi servono. Assegnatene il minor numero possibile.
- 3
Confermare la rinuncia
Due frasi sul recesso, una volta sola. Ogni ordine effettuato con la chiave vi fa riferimento.
- 4
Proteggere la chiave
Viene mostrata una sola volta. Conservatela come una password e inserite nell'elenco gli indirizzi IP dei vostri server.
- 5
Impostare un limite giornaliero
La somma di tutti gli ordini di un giorno è limitata: €250 per una nuova chiave, regolabile fino a €5,000.
- 6
Inviare la prima chiamata
Con la chiave nell'intestazione «Authorization». L'esempio qui sotto legge i primi prodotti.
La prima chiamata
Una chiave inizia con omk_live_. Va in ogni chiamata come valore Bearer. Gli importi sono indicati in centesimi interi e includono la commissione di servizio.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# solo ciò che è cambiato dalla vostra ultima sincronizzazione
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Continuare nella documentazione
Il negozio non è ancora aperto: le chiamate che modificano qualcosa rispondono 403 showcase_mode e le risposte non contengono prezzi.
Domande frequenti
Quanto costa l'API?
L'accesso è gratuito. Pagate gli ordini che avviate. Non c'è un canone fisso.
Esiste un kit software?
Non ancora. La documentazione contiene esempi con curl e il file OpenAPI si può caricare negli strumenti più comuni.
Come ottengo limiti più alti?
Scriveteci il vostro progetto e il vostro volume. Aumentiamo i limiti per i partner di cui vediamo l'esigenza.
Cosa succede se la mia chiave viene rubata?
Revocatela nella pagina delle chiavi e createne una nuova. Fino ad allora il limite giornaliero e l'elenco IP contengono il danno. Chiamate anomale bloccano la chiave automaticamente.
Dove segnalo un errore nell'API?
Tramite il modulo di contatto con l'argomento API. Indicate la chiamata e l'orario.
Pronti per la prima chiamata?
Leggete per intero la pagina per sviluppatori, poi create una chiave.
Invia una richiesta