Anteprima: Capydra apre a breve. Non è ancora possibile ordinare.

Capydra
Plus Aiuto Carrello
Offerta della settimana

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.

Presto disponibileAlla 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.

Pronta, si apre con l'avvio delle vendite

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 vendite
  • Avviare 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 vendite
  • Ritirare 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 vendite
  • Ricevere webhook

    Chiamate firmate al vostro server quando cambia un ordine o un prodotto. Fino a 3 indirizzi.

    Pronta, si apre con l'avvio delle vendite
  • Offrire 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 vendite
  • Usare 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. 1

    Creare un account

    Vi registrate nel negozio.

  2. 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. 3

    Confermare la rinuncia

    Due frasi sul recesso, una volta sola. Ogni ordine effettuato con la chiave vi fa riferimento.

  4. 4

    Proteggere la chiave

    Viene mostrata una sola volta. Conservatela come una password e inserite nell'elenco gli indirizzi IP dei vostri server.

  5. 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. 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

403

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