De API van Ultineo AI
Voer de applicaties uit de catalogus uit vanuit je eigen software. De API spreekt JSON via HTTPS, authenticeert elke aanroep met een projectsleutel en beantwoordt elke aanroep in hetzelfde formaat.
Gebouwd rond drie resources
- Catalogus
De gepubliceerde applicaties, de meest gebruikte eerst, elk met de invoervelden die ze verwacht.
- Uitvoeringen
Eén aanroep start een applicatie met de invoer; een andere leest de uitvoering terug met het antwoord.
- Sleutels
Projectsleutels met rechten, een optionele vervaldatum en een status die je kunt uitschakelen.
Authenticatie en rechten
- Een bearer-sleutel
Stuur je projectsleutel bij elke aanroep mee in de Authorization-header, uitsluitend via HTTPS.
- Beperkt tot één project
Een sleutel is aan één project gekoppeld en kan nooit de gegevens van een ander project lezen of schrijven, welk verzoek er ook komt.
- Opgeslagen als hash
Alleen een hash van de sleutel wordt bewaard, dus een sleutel wordt maar één keer volledig getoond. Een verloren sleutel wordt vervangen, nooit hersteld.
Start een uitvoering en lees het antwoord
- Aanmaken
Noem de applicatie en geef één waarde per invoerveld, met als sleutel de veldnaam die de catalogus teruggeeft.
- Volgen
Uitvoeringen zijn asynchroon: lees de uitvoering opnieuw uit tot de status voltooid of mislukt is. Beide zijn definitief.
- Lezen
Een voltooide uitvoering bevat het antwoord, de duur en het aantal tokens voor invoer en uitvoer.
Eén vast formaat voor elk antwoord
- Altijd dezelfde drie velden
Elk antwoord bevat de statuscode, een korte titel en de respons, bij succes en bij een fout.
- Vaste meldingen
Foutmeldingen zijn vaste Engelse teksten die het ontbrekende recht of de geweigerde waarde noemen.
- Duidelijke abonnementslimieten
Een aanroep die niet onder het abonnement valt, of die het tegoed zou overschrijden, wordt geweigerd met een eigen statuscode.
Een sleutel krijgen
API-toegang zit in de betaalde abonnementen van Ultineo AI. Zelf aanmelden kan nog niet: ons team opent je project en geeft je de eerste sleutel.
Koppel je software aan Ultineo AI
Vertel ons wat je wilt automatiseren, dan openen wij je project en de API-sleutel ervan.
Vragen over de API
De betaalde abonnementen. Het gratis abonnement geeft toegang tot de applicaties, zonder de API.
Nee. De instructies zijn van de eigenaar van de applicatie. De API geeft de invoervelden terug, want die vult de aanroeper in.
Het aanmaken van een uitvoering antwoordt meteen met de nieuwe status. Lees de uitvoering opnieuw uit tot ze voltooid is om het antwoord te krijgen.
Ja. Elke sleutel heeft rechten en een optionele vervaldatum, en een sleutel kan nooit een andere sleutel maken met ruimere rechten dan de eigen rechten.