API Ultineo Reasoning
Zaganjajte aplikacije iz kataloga iz svoje programske opreme. API uporablja JSON prek HTTPS, vsak klic preveri s ključem projekta in na vsak klic odgovori v enaki obliki.
Zgrajen okoli aplikacij, izvajanj in ključev
- Aplikacije
Ustvarite aplikacijo iz njenih vnosnih polj in navodil, nato pa svoje aplikacije izpišite, preberite in urejajte.
- Runs and usage
En klic zažene aplikacijo z njenimi vhodnimi podatki, drugi prebere izvajanje skupaj z odgovorom. Povzetek prikazuje žetone, porabljene v tekočem obračunskem tednu, in njihov znesek.
- Ključi
Ključi projekta s pravicami, neobveznim rokom veljavnosti in stanjem, ki ga lahko izklopite.
Integrirajte ga kjerkoli
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- V vaših avtomatizacijah
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Od enega odgovora do naslednjega
Odgovor enega izvajanja lahko postane polje naslednjega: vaša koda povezuje korake, kot želi.
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.
Kaj pošljete
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Kaj ste prebrali nazaj
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Preverjanje pristnosti in pravice
- Ključ tipa bearer
Ključ svojega projekta pošljite v glavi Authorization vsakega klica, samo prek HTTPS.
- Omejen na en projekt
Ključ je vezan na en projekt in nikoli ne more brati ali pisati podatkov drugega projekta, ne glede na zahtevo.
- Shranjen kot zgoščena vrednost
Shrani se samo zgoščena vrednost ključa, zato je ključ v celoti prikazan samo enkrat. Izgubljen ključ se zamenja, nikoli ne obnovi.
Zaženite izvajanje in preberite njegov odgovor
- Ustvarjanje
Navedite aplikacijo in za vsako vnosno polje podajte eno vrednost, s ključem, ki je ime polja, kot ga vrne aplikacija.
- Spremljanje
Izvajanja so asinhrona: izvajanje berite znova, dokler njegovo stanje ni končano ali neuspešno. Obe stanji sta končni.
- Branje
Končano izvajanje vsebuje svoj odgovor, trajanje in število žetonov za vhod in izhod.
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.
Enotna oblika za vsak odgovor
- Isti trije ključi
Vsak odgovor vsebuje statusno kodo, kratek naslov in vsebino odgovora, tako ob uspehu kot ob neuspehu.
- Stalna sporočila
Sporočila o napakah so stalni nizi v angleščini, ki navedejo manjkajočo pravico ali zavrnjeno vrednost.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Pridobitev ključa
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.
Povežite svojo programsko opremo z Ultineo Reasoning
Povejte nam, kaj želite avtomatizirati, in odprli bomo vaš projekt ter njegov ključ API.
Vprašanja o API-ju
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Ne. Navodila pripadajo lastniku aplikacije. API vrne vnosna polja, saj prav ta izpolni klicatelj.
Ustvarjanje izvajanja takoj vrne stanje novo. Izvajanje berite znova, dokler ni končano, da dobite odgovor.
Da. Vsak ključ ima pravice in neobvezen rok veljavnosti, ključ pa nikoli ne more ustvariti drugega ključa s širšimi pravicami od svojih.