Ultineo Reasoning

De API van Ultineo Reasoning

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 apps, uitvoeringen en sleutels

Apps

Maak een app op basis van de invoervelden en de instructies, en bekijk, lees en bewerk daarna je apps.

Runs and usage

Eén aanroep start een app met de invoer; een andere leest de uitvoering terug met het antwoord. Een overzicht toont de tokens die je in de lopende factuurweek hebt gebruikt en het bedrag ervan.

Sleutels

Projectsleutels met rechten, een optionele vervaldatum en een status die je kunt uitschakelen.

Integreer het overal

In your software

Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.

In je automatiseringen

A script or an automation tool launches a run at each event: a form received, a file dropped.

Van het ene antwoord naar het andere

Het antwoord van één run kan een veld van de volgende worden: uw code koppelt de stappen zoals die dat wil.

Reasoning chains

The same run, through the API

Your software sends the application’s identifier and its fields, then reads the run back until it is finished.

Wat u verstuurt

{
  "app_id": "mapp_0ceacb46e5b3a99e91b6",
  "data": {
    "message": "My parcel has not arrived and the tracking has not moved for a week."
  }
}

Wat u terugleest

{
  "id": "runi_1b7f4e0c96a2d8531fca",
  "object": "reasoning",
  "status": "finished",
  "response": { "miid_9a4c07e5b312df8641ca": "urgent" },
  "tokens": { "input": 412, "output": 3, "total": 415 },
  "duration": 1.84
}

Read the API documentation

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 applicatie 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.

The runs your software started, one by one

Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.

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.

Refusals are explicit

A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.

Een sleutel krijgen

API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.

See the pricing

Koppel je software aan Ultineo Reasoning

Vertel ons wat je wilt automatiseren, dan openen wij je project en de API-sleutel ervan.

Vragen over de API

Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.

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.