API'et til Ultineo AI
Kør katalogets applikationer fra din egen software. API'et taler JSON over HTTPS, autentificerer hvert kald med en projektnøgle og besvarer alle kald i samme format.
Bygget op om tre ressourcer
- Katalog
De publicerede applikationer, de mest brugte først, hver med de inputfelter, den forventer.
- Kørsler
Ét kald starter en applikation med dens input; et andet læser kørslen tilbage med dens svar.
- Nøgler
Projektnøgler med rettigheder, en valgfri udløbsdato og en status, du kan slå fra.
Autentificering og rettigheder
- En bearer-nøgle
Send din projektnøgle i Authorization-headeren i hvert kald, kun over HTTPS.
- Begrænset til ét projekt
En nøgle er knyttet til ét projekt og kan aldrig læse eller skrive data i et andet projekt, uanset forespørgslen.
- Gemt som en hash
Kun en hash af nøglen gemmes, så en nøgle vises i sin helhed én gang. En mistet nøgle erstattes og gendannes aldrig.
Start en kørsel, og læs dens svar
- Opret
Angiv applikationen, og giv én værdi pr. inputfelt, angivet med det feltnavn, som kataloget returnerer.
- Følg
Kørsler er asynkrone: læs kørslen igen, indtil dens status er færdig eller mislykket. Begge er endelige.
- Læs
En færdig kørsel indeholder sit svar, sin varighed og sit tokenforbrug for input og output.
Ét fast format for alle svar
- Altid de samme tre felter
Hvert svar indeholder statuskoden, en kort titel og selve indholdet, både ved succes og ved fejl.
- Stabile meddelelser
Fejlmeddelelser er stabile engelske tekststrenge, der nævner den manglende rettighed eller den afviste værdi.
- Planens grænser er tydelige
Et kald, som planen ikke dækker, eller som ville overskride dens kvote, afvises med en særskilt statuskode.
Sådan får du en nøgle
API-adgang følger med de betalte Ultineo AI-planer. Der er endnu ingen selvbetjent tilmelding: vores team opretter dit projekt og giver dig dets første nøgle.
Forbind din software med Ultineo AI
Fortæl os, hvad du vil automatisere, så opretter vi dit projekt og dets API-nøgle.
Spørgsmål om API'et
De betalte planer. Gratisplanen giver adgang til applikationerne uden API'et.
Nej. Instruktionerne tilhører applikationens ejer. API'et returnerer inputfelterne, som er det, den der kalder API'et, udfylder.
Når du opretter en kørsel, svarer API'et straks med den nye status. Læs kørslen igen, indtil den er færdig, for at få svaret.
Ja. Hver nøgle har rettigheder og en valgfri udløbsdato, og en nøgle kan aldrig oprette en anden nøgle med bredere rettigheder end sine egne.