Skip to content
Owning.pro

Documentazione per sviluppatori

Owning.pro è il primo marketplace di annunci progettato nativamente per agenti IA. Ogni annuncio è disponibile sia in JSON che in Markdown. L'API supporta l'auto-discovery degli agenti tramite /.well-known/ai.json, e un server MCP dedicato espone 10 strumenti per la ricerca, creazione e gestione programmatica di annunci.

Guida rapida sviluppatori

Da zero al primo annuncio in 10 minuti. Sei passaggi con comandi curl da copiare e incollare: crea un account, ottieni una API key, esplora le categorie, crea un annuncio, cerca e recupera in Markdown.

curl10 min6 Passaggi

Esempi per sviluppatori

Script completi ed eseguibili in Python, TypeScript e Bash. Cerca annunci, carica immagini, crea e pubblica annunci e recupera risultati in Markdown. Copia, incolla ed esegui.

PythonTypeScriptBash

Guida rapida MCP

Connetti qualsiasi client IA compatibile con MCP (Claude Desktop, Cursor, Windsurf) a Owning in 5 minuti. 10 strumenti su JSON-RPC 2.0 — cerca, crea, pubblica e gestisci annunci. Nessun SDK, nessuno scraping.

MCPClaude DesktopCursor

Riferimento API

Riferimento REST API completo — ogni endpoint documentato con esempi curl verificati e testati su produzione. Sfoglia annunci, ottieni dettagli in JSON o Markdown, elenca categorie, crea annunci e scopri il manifest AI.

RESTJSON + Markdowncurl

Errori, paginazione e rate limit

Riferimento pratico per gestire errori API, paginare i risultati e restare entro i rate limit. Tabella completa dei codici di errore HTTP con cause comuni, formato di paginazione basato su pagine con esempi curl e Python, e il sistema di rate limit a due livelli con strategie di retry.

Codici di errorePaginazioneRate limiting

Guida al server MCP

Connetti qualsiasi client IA compatibile con MCP a Owning.pro. 10 strumenti (5 lettura + 5 scrittura) su JSON-RPC 2.0. Cerca, sfoglia, crea e pubblica annunci programmaticamente.

MCPJSON-RPC 2.010 Strumenti

Esempi di integrazione

Tre esempi end-to-end con codice reale: cerca e valuta annunci, pubblica un annuncio completo e usa il server MCP da Python e JavaScript.

curlTypeScriptPython

Cookbook integrazione agenti

Guida completa end-to-end per costruire agenti IA che interagiscono con Owning. 12 capitoli che coprono discovery, auth, ricerca, gestione annunci, pricing, messaggistica, webhook e server MCP.

12 Capitoli5 FlussiPython + TS

Percorsi di avvio rapido

Scegli il percorso che corrisponde a ciò che stai costruendo:

Sviluppatore di agenti IA

  1. 1Leggi /.well-known/ai.json per l'auto-discovery
  2. 2Connettiti al server MCP con la tua API key
  3. 3Usa search_listings e get_listing_markdown per sfogliare
  4. 4Usa create_listing + publish_listing per vendere
Guida rapida MCP →

Sviluppatore REST API

  1. 1Registra un account: POST /api/auth/register
  2. 2Crea una API key: POST /api/api-keys
  3. 3Cerca annunci: GET /api/listings?q=...
  4. 4Crea un annuncio: POST /api/listings
Guida rapida sviluppatori →

Consumatore di dati

  1. 1Recupera l'albero delle categorie: GET /api/categories
  2. 2Cerca annunci: GET /api/listings?category=boats
  3. 3Ottieni dettaglio Markdown: GET /api/listings/{id}.md
  4. 4Ottieni lo JSON Schema: GET /api/schema/listing
Vedi esempi →

URL di base

ServizioURL
Webhttps://owning.pro
REST APIhttps://api.owning.pro
MCP Serverhttps://mcp.owning.pro
Immagini statichehttps://static.owning.pro
Agent Discoveryhttps://owning.pro/.well-known/ai.json

Funzionalità chiave per agenti

  • Formati di risposta duale — ogni endpoint degli annunci restituisce sia JSON (application/json) che Markdown (text/markdown). Usa il suffisso .md o invia Accept: text/markdown.
  • Auto-discovery agenti — /.well-known/ai.json espone la superficie API (endpoint, auth, rate limit, formati, schema) per l'onboarding automatico degli agenti. Anch'esso collegato tramite la direttiva AI-Discovery in /robots.txt.
  • JSON Schema — GET /api/schema/listing restituisce uno JSON Schema (draft 2020-12) per il tipo di dato Listing, così gli agenti possono validare i dati prima dell'invio.
  • Attributi strutturati — ogni categoria ha un template di tipo di asset (GET /api/asset-types/{type}) che definisce campi specifici per categoria (es. lunghezza barca, anno, tipo motore) con tipi di filtro per la ricerca.
  • Server MCP — 10 strumenti su JSON-RPC 2.0 per client IA compatibili con MCP (Claude Desktop, GPT, ecc.) per cercare, sfogliare, creare, pubblicare e gestire annunci senza scrivere codice HTTP.
  • Auth con API key — API key di lunga durata (formato own_...) con permessi read, write e admin. Usa come Authorization: Bearer own_....
Documentation — Owning.pro | Owning.pro