{"id":217485,"date":"2026-08-22T09:19:20","date_gmt":"2026-08-22T07:19:20","guid":{"rendered":"https:\/\/fivemx.com\/developers\/"},"modified":"2026-08-22T09:19:20","modified_gmt":"2026-08-22T07:19:20","slug":"sviluppatori","status":"publish","type":"page","link":"https:\/\/fivemx.com\/it\/sviluppatori\/","title":{"rendered":"FiveMX Portale Sviluppatori"},"content":{"rendered":"<p class=\"has-large-font-size wp-block-paragraph\">FiveMX pubblica un HTTP API di sola lettura sul suo catalogo di script FiveM, una descrizione OpenAPI 3.1 di esso e uno strumento a riga di comando che comunica con esso. Tutto in questa pagina \u00e8 pubblico, non richiede chiavi e pu\u00f2 essere utilizzato da una persona, uno script o un agente.<\/p><h2 class=\"wp-block-heading\">Il catalogo FiveMX API<\/h2><p class=\"wp-block-paragraph\">Un namespace, quattro endpoint GET, JSON solo. Espone gli stessi 1.675 prodotti pubblicati del negozio, con prezzi nella valuta base del negozio, scorte, categoria e tag del framework.<\/p><h3 class=\"wp-block-heading\">URL di base<\/h3><pre data-no-translation=\"\" class=\"wp-block-code\"><code data-no-translation=\"\">https:\/\/fivemx.com\/wp-json\/fivemx\/v1<\/code><\/pre><h3 class=\"wp-block-heading\">Endpoint<\/h3><ul class=\"wp-block-list\"><li><code data-no-translation=\"\">GET \/catalog<\/code> \u2014 indice con conteggi, valuta e link a tutto il resto in questa pagina<\/li><li><code data-no-translation=\"\">GET \/catalog\/categories<\/code> \u2014 tutte le 46 categorie con conteggio prodotti<\/li><li><code data-no-translation=\"\">GET \/catalog\/products<\/code> \u2014 una pagina di prodotti, filtrabile per <code data-no-translation=\"\">category<\/code> E <code data-no-translation=\"\">framework<\/code>, fino a 50 per pagina<\/li><li><code data-no-translation=\"\">GET \/catalog\/products\/{slug}<\/code> \u2014 un singolo prodotto tramite il suo slug inglese<\/li><\/ul><h3 class=\"wp-block-heading\">Autenticazione e scritture<\/h3><p class=\"wp-block-paragraph\">Non ce n'\u00e8 nessuna, e non ce ne sono. Ogni endpoint \u00e8 un GET anonimo. Niente qui crea un ordine, cambia un prezzo o tocca un account, quindi non c'\u00e8 nessuna chiave da divulgare e nessuno stato da danneggiare con un errore.<\/p><h2 class=\"wp-block-heading\">Specifiche OpenAPI<\/h2><p class=\"wp-block-paragraph\">La descrizione completa leggibile dalla macchina, generata dallo stesso contratto contro cui \u00e8 implementato il API, in modo che i due non possano divergere:<\/p><ul class=\"wp-block-list\"><li><code data-no-translation=\"\">https:\/\/fivemx.com\/openapi.json<\/code><\/li><li><code data-no-translation=\"\">https:\/\/fivemx.com\/.well-known\/openapi.json<\/code> \u2014 byte identico, per i client che guardano prima l\u00ec<\/li><li><code data-no-translation=\"\">https:\/\/fivemx.com\/.well-known\/api-catalog<\/code> \u2014 un linkset RFC 9727 che punta a entrambi<\/li><\/ul><p class=\"wp-block-paragraph\">La homepage lo pubblicizza anche con un <code data-no-translation=\"\">rel=\"service-desc\"<\/code> link, e <code data-no-translation=\"\">https:\/\/fivemx.com\/llms.txt<\/code> descrive il sito per i modelli linguistici.<\/p><h2 class=\"wp-block-heading\">Il FiveMX CLI<\/h2><p class=\"wp-block-paragraph\">Uno strumento da riga di comando ufficiale racchiude lo stesso API. Node 18 o versioni successive, zero dipendenze runtime.<\/p><pre data-no-translation=\"\" class=\"wp-block-code\"><code data-no-translation=\"\">npm install -g @fivemx\/cli\nfivemx catalog\nfivemx products --framework qbcore --per-page 5\nfivemx product audio-speaker-script --json<\/code><\/pre><p class=\"wp-block-paragraph\">I codici di uscita separano un errore di utilizzo da un'interruzione senza analizzare alcun output: <code data-no-translation=\"\">0<\/code> ok, <code data-no-translation=\"\">1<\/code> errore di utilizzo senza richiesta inviata, <code data-no-translation=\"\">2<\/code> la richiesta \u00e8 fallita, <code data-no-translation=\"\">3<\/code> la risorsa non esiste.<\/p><h2 class=\"wp-block-heading\">Risposte di errore<\/h2><p class=\"wp-block-paragraph\">Gli errori sono JSON, mai una pagina HTML, e ognuno porta un codice, un messaggio e un suggerimento che dice cosa fare dopo.<\/p><pre data-no-translation=\"\" class=\"wp-block-code\"><code data-no-translation=\"\">{\n  \"code\": \"fivemx_product_not_found\",\n  \"message\": \"No published product has that slug.\",\n  \"data\": {\n    \"status\": 404,\n    \"hint\": \"Slugs come from \/wp-json\/fivemx\/v1\/catalog\/products.\"\n  }\n}<\/code><\/pre><p class=\"wp-block-paragraph\">Un client che invia <code data-no-translation=\"\">Accept: application\/json<\/code>, o che si identifica come un agente AI noto, riceve questa forma per qualsiasi percorso mancante sul sito, non solo all'interno dello spazio dei nomi API. Un browser mantiene la normale pagina di errore.<\/p><h2 class=\"wp-block-heading\">Limiti di frequenza e caching<\/h2><p class=\"wp-block-paragraph\">Non esiste una quota pubblicata. Le risposte vengono memorizzate nella cache per dieci minuti all'origine, quindi l'esplorazione dell'intero catalogo \u00e8 economica per entrambe le parti. Invia un user agent che ti identifichi e preferisci un passaggio paginato a molte richieste di singoli prodotti.<\/p><h2 class=\"wp-block-heading\">Cosa questo API deliberatamente non fa<\/h2><ul class=\"wp-block-list\"><li>Non espone carrelli, checkout, ordini, clienti o download. Questi percorsi sono chiusi ai crawler in <code data-no-translation=\"\">robots.txt<\/code> e non sono descritti dalla specifica.<\/li><li>Non serve slug tradotti. Le versioni locali del sito utilizzano URL tradotti, e questo API accetta solo lo slug inglese.<\/li><li>Non converte i prezzi. I valori sono nella valuta di base riportata da <code data-no-translation=\"\">\/catalog<\/code>, non nella valuta selezionata da un visitatore.<\/li><li>Non c'\u00e8 server MCP, nessuna scheda agente e nessun feed webhook. Quando esister\u00e0 uno, sar\u00e0 elencato qui e nel catalogo API piuttosto che annunciato da un file vuoto.<\/li><\/ul><p class=\"wp-block-paragraph\">Le domande sul API appartengono al <a href=\"\/it\/contatti\/\">Pagina di contatto FiveMX<\/a>.<\/p>","protected":false},"excerpt":{"rendered":"<p>FiveMX publishes a read-only HTTP API over its FiveM script catalogue, an OpenAPI 3.1 description of it, and a command line tool that speaks to it. Everything on this page is public, needs no key and can be used by a person, a script or an agent. The FiveMX catalogue API One namespace, four GET [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-217485","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/pages\/217485","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/comments?post=217485"}],"version-history":[{"count":0,"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/pages\/217485\/revisions"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/it\/wp-json\/wp\/v2\/media?parent=217485"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}