API-overzicht - Macaly Documentation

De Macaly API stelt externe applicaties in staat om chatsessies aan te maken, webapplicaties te bouwen met AI en deze programmatisch in productie te implementeren.

Alleen beschikbaar in het pakket Bureaus

Basis-URL

https://www.macaly.com

Snel starten

Haal een API-sleutel op - Zie Authenticatie
Maak een chat aan - Stuur een prompt om te beginnen met bouwen
Controleer de status - Wacht tot de AI klaar is
Implementeer - Publiceer uw app in productie

Beschikbare endpoints

Methode	Endpoint	Beschrijving
POST	`/api/chat`	Een nieuwe chat aanmaken en beginnen met bouwen
POST	`/api/chat/{chatId}/publish`	Een bericht naar een bestaande chat sturen
POST	`/api/client-app/assets/upload`	Een bestand uploaden en een permanente CDN-URL ontvangen
GET	`/api/chat/{chatId}/status`	Workflowstatus opvragen
GET	`/api/chat/{chatId}/subscribe`	Abonneren op de realtime stream
POST	`/api/chat/{chatId}/deploy`	Chat implementeren in productie
GET	`/api/chat/{chatId}/deployment`	Implementatiestatus ophalen

Limieten en credits

API-verzoeken verbruiken credits van het saldo van uw team
Elke chataanmaak kost hetzelfde als via de webinterface
Mislukte API-sleutelpogingen zijn gelimiteerd (5 per minuut per IP)
Houd uw verbruik in de gaten via Instellingen → Gebruik en limieten

Foutafhandeling

Alle fouten retourneren JSON met een error-veld:

{
  "error": "Error message here"
}

HTTP-statuscodes

Status	Beschrijving
400	Bad Request - Ongeldig verzoek
401	Unauthorized - Ongeldige of ontbrekende API-sleutel
402	Payment Required - Onvoldoende credits
403	Forbidden - Geen toestemming of verkeerd team
404	Not Found - Resource niet gevonden
422	Unprocessable Entity - Validatiefout
429	Too Many Requests - Limiet bereikt
500	Internal Server Error - Serverfout
503	Service Unavailable - Server is bezig, probeer het later opnieuw