Panoramica dell'API - Macaly Documentation

L’API di Macaly permette ad applicazioni esterne di creare chat, realizzare applicazioni web con l’IA ed effettuarne il deployment in produzione in modo programmatico.

Disponibile solo con il piano Agenzie

URL di base

https://www.macaly.com

Avvio rapido

Ottieni una chiave API - Vedi Autenticazione
Crea una chat - Invia un prompt per iniziare a realizzare la tua app
Segui l’avanzamento - Attendi che l’IA finisca
Effettua il deployment - Pubblica la tua app in produzione

Endpoint disponibili

Metodo	Endpoint	Descrizione
POST	`/api/chat`	Creazione di una nuova chat e avvio del lavoro
POST	`/api/chat/{chatId}/publish`	Invio di un messaggio a una chat esistente
POST	`/api/client-app/assets/upload`	Caricamento di un file e ottenimento di una URL CDN permanente
GET	`/api/chat/{chatId}/status`	Verifica dello stato dell’elaborazione
GET	`/api/chat/{chatId}/subscribe`	Sottoscrizione allo stream in tempo reale
POST	`/api/chat/{chatId}/deploy`	Deployment della chat in produzione
GET	`/api/chat/{chatId}/deployment`	Verifica dello stato del deployment

Limiti di richieste e crediti

Le richieste API consumano crediti dal saldo del tuo team
La creazione di ogni chat costa quanto l’utilizzo dell’interfaccia web
I tentativi falliti con la chiave API sono soggetti a un limite di richieste (5 al minuto per indirizzo IP)
Controlla il tuo utilizzo in Impostazioni → Utilizzo e limiti

Gestione degli errori

Tutti gli errori restituiscono un JSON con un campo error:

{
  "error": "Error message here"
}

Codici di stato HTTP

Codice	Descrizione
400	Bad Request: corpo della richiesta non valido
401	Unauthorized: chiave API non valida o mancante
402	Payment Required: crediti insufficienti
403	Forbidden: permessi insufficienti o team errato
404	Not Found: risorsa non trovata
422	Unprocessable Entity: errore di validazione
429	Too Many Requests: limite di richieste raggiunto
500	Internal Server Error: errore lato server
503	Service Unavailable: il server è occupato, riprova più tardi

​URL di base

​Avvio rapido

​Endpoint disponibili

​Limiti di richieste e crediti

​Gestione degli errori

​Codici di stato HTTP

URL di base

Avvio rapido

Endpoint disponibili

Limiti di richieste e crediti

Gestione degli errori

Codici di stato HTTP