Integreer ZyloPro in uw applicaties
https://api.zylopro.comRegistreer u op ZyloPro om uw account en organisatie aan te maken. Vervolgens kunt u via de API inloggen om een toegangstoken te verkrijgen.
De API gebruikt JWT (Bearer) tokens. Voeg het token toe in de Authorization-header van uw verzoeken:
Eenmaal geauthenticeerd kunt u beschikbare agenten opvragen, analyses uitvoeren en resultaten ophalen.
De authenticatie-endpoints beheren gebruikersaccounts, toegangstokens en wachtwoorden.
/api/auth/registerRegistratie van een nieuwe organisatie met eigenaar
{
"email": "string",
"password": "string",
"firstName": "string",
"lastName": "string",
"organizationName": "string"
}{ success: boolean, token?: string, refreshToken?: string, user?: UserDto }/api/auth/loginGebruiker inloggen
{
"email": "string",
"password": "string"
}{ success: boolean, token?: string, refreshToken?: string, user?: UserDto }/api/auth/refreshToegangstoken vernieuwen met refresh token
{
"refreshToken": "string"
}{ success: boolean, token?: string, refreshToken?: string }/api/auth/revokeRefresh token intrekken (uitloggen)
{
"refreshToken": "string"
}{ message: string }/api/auth/verify-emailE-mailadres verifiëren met het per e-mail ontvangen token
{
"token": "string"
}{ message: string }/api/auth/forgot-passwordWachtwoord reset aanvragen
{
"email": "string"
}{ message: string }/api/auth/reset-passwordWachtwoord resetten met het per e-mail ontvangen token
{
"token": "string",
"newPassword": "string"
}{ message: string }/api/auth/change-passwordWachtwoord wijzigen (ingelogde gebruiker)
{
"currentPassword": "string",
"newPassword": "string"
}{ message: string }De agent-endpoints stellen u in staat om de 10 AI-modules van het platform op te vragen, te abonneren en uit te voeren.
/api/agentsAlle beschikbare agenten op het platform ophalen
AgentDto[]/api/agents/organizationDoor de organisatie geabonneerde agenten ophalen (Admin)
AgentDto[]/api/agents/myAgenten toegankelijk voor de ingelogde gebruiker ophalen
AgentDto[]/api/agents/{agentId}/subscribeAbonneren op een agent (organisatieniveau)
{
"agentId": "int"
}{ message: string }/api/agents/{agentId}/unsubscribeAbonnement op een agent opzeggen
{
"agentId": "int"
}{ message: string }/api/agents/{code}/executeEen agent uitvoeren met invoergegevens
{
"code": "string (ex: proposalcraft)"
}{
"inputData": "string",
"projectId": "guid? (optionnel)",
"metadata": "Record<string, string>? (optionnel)"
}{ success: boolean, status: string, executionId: guid, outputData?: string, error?: string }/api/agents/executions/{executionId}Status van een uitvoering ophalen
{
"executionId": "guid"
}AgentExecutionDto/api/agents/executions/{executionId}/cancelEen lopende uitvoering annuleren
{
"executionId": "guid"
}{ message: string }/api/agents/executionsUitvoeringsgeschiedenis van de gebruiker ophalen
{
"limit": "int (défaut: 20)"
}AgentExecutionDto[]// Exemple de connexion
const response = await fetch('https://api.zylopro.com/api/auth/login', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'user@example.com',
password: 'votre-mot-de-passe'
})
});
const data = await response.json();
// Stocker le token pour les requêtes ultérieures
const accessToken = data.token;// Exemple d'exécution d'un agent
const response = await fetch('https://api.zylopro.com/api/agents/proposalcraft/execute', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${accessToken}`
},
body: JSON.stringify({
inputData: "Contenu de l'appel d'offres à analyser...",
metadata: {
projectName: "Étude satisfaction client 2025",
clientName: "ACME Corp"
}
})
});
const result = await response.json();
console.log('Exécution ID:', result.executionId);
console.log('Statut:', result.status);// Exemple de polling pour suivre une exécution
async function waitForCompletion(executionId, accessToken) {
while (true) {
const response = await fetch(
`https://api.zylopro.com/api/agents/executions/${executionId}`,
{
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
const execution = await response.json();
if (execution.status === 'Completed') {
return execution;
}
if (execution.status === 'Failed') {
throw new Error(execution.errorMessage);
}
// Attendre 2 secondes avant le prochain check
await new Promise(resolve => setTimeout(resolve, 2000));
}
}{
id: number
code: string
name: string
shortDescription: string
longDescription: string
category: string
inputType: string
outputType: string
monthlyPrice: number
includedExecutions: number
extraExecutionPrice: number
iconName: string
color: string
isActive: boolean
isBeta: boolean
isSubscribed: boolean
hasAccess: boolean
}{
id: guid
agentCode: string
agentName: string
status: "Pending" | "Running" |
"Completed" | "Failed" |
"Cancelled"
createdAt: datetime
startedAt: datetime | null
completedAt: datetime | null
durationSeconds: number | null
inputTokens: number | null
outputTokens: number | null
outputFilePath: string | null
errorMessage: string | null
}| HTTP-code | Beschrijving |
|---|---|
| 200 | Succes |
| 400 | Ongeldig verzoek (ontbrekende of onjuiste parameters) |
| 401 | Niet geauthenticeerd (ontbrekend of verlopen token) |
| 403 | Toegang geweigerd (onvoldoende machtigingen) |
| 404 | Bron niet gevonden |
| 429 | Te veel verzoeken (rate limiting) |
| 500 | Interne serverfout |
{
"message": "Description de l'erreur",
"errors": {
"fieldName": ["Détail de l'erreur de validation"]
}
}De API is beperkt tot 100 verzoeken per minuut per gebruiker. De X-RateLimit-*-headers geven uw quotumstatus aan.
Elk plan heeft een maandelijks aantal uitvoeringen per agent. Controleer uw dashboard om uw verbruik te volgen.
Ons technisch team staat klaar om u te begeleiden bij de integratie van de ZyloPro API.