Aan de slag
API-overzicht
Bouw en implementeer webapplicaties programmatisch met de Macaly API
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.
Basis-URL
https://www.macaly.comSnel 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 |