API Ultineo Reasoning-ja
Pokrećite aplikacije iz kataloga iz vlastitog softvera. API koristi JSON preko HTTPS-a, autentificira svaki poziv ključem projekta i na svaki poziv odgovara u istom formatu.
Izgrađen oko aplikacija, izvođenja i ključeva
- Aplikacije
Izradite aplikaciju iz njezinih polja za unos i uputa, a zatim pregledavajte, čitajte i uređujte svoje aplikacije.
- Runs and usage
Jedan poziv pokreće aplikaciju s njezinim ulaznim podacima; drugi čita izvođenje zajedno s odgovorom. Sažetak prikazuje tokene potrošene u tekućem obračunskom tjednu i njihov iznos.
- Ključevi
Ključevi projekta s ovlastima, neobaveznim rokom valjanosti i statusom koji možete isključiti.
Ugradi bilo gdje
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- U vašim automatizacijama
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Od jednog odgovora do drugog
Odgovor jedne provedbe može postati polje sljedeće: vaš kod spaja korake kako ž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.
Što šalješ
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Što pročitate natrag
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
} Autentifikacija i ovlasti
- Ključ tipa bearer
Šaljite ključ svojeg projekta u zaglavlju Authorization svakog poziva, isključivo putem HTTPS-a.
- Ograničen na jedan projekt
Ključ je vezan uz jedan projekt i nikada ne može čitati ni pisati podatke drugog projekta, kakav god bio zahtjev.
- Pohranjen kao sažetak
Čuva se samo sažetak (hash) ključa, pa se ključ u cijelosti prikazuje samo jednom. Izgubljeni ključ zamjenjuje se, nikada se ne vraća.
Pokrenite izvođenje i pročitajte njegov odgovor
- Stvaranje
Navedite aplikaciju i za svako ulazno polje dostavite po jednu vrijednost, s ključem jednakim nazivu polja koji vraća aplikacija.
- Praćenje
Izvođenja su asinkrona: ponovno čitajte izvođenje dok mu status ne bude završeno ili neuspjelo. Oba su konačna.
- Čitanje
Završeno izvođenje sadrži svoj odgovor, trajanje i broj tokena za ulaz i izlaz.
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.
Jedinstven format za svaki odgovor
- Ista tri ključa
Svaki odgovor sadrži statusni kod, kratak naslov i sadržaj odgovora, i pri uspjehu i pri neuspjehu.
- Stabilne poruke
Poruke o pogreškama stabilni su nizovi na engleskom koji navode ovlast koja nedostaje ili odbijenu vrijednost.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Dobivanje 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 svoj softver s Ultineo Reasoning-jem
Recite nam što želite automatizirati, a mi ćemo otvoriti vaš projekt i njegov API ključ.
Pitanja o API-ju
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
Ne. Upute pripadaju vlasniku aplikacije. API vraća ulazna polja jer upravo njih ispunjava pozivatelj.
Stvaranje izvođenja odmah vraća status novo. Ponovno čitajte izvođenje dok ne bude završeno da biste dobili odgovor.
Da. Svaki ključ ima ovlasti i neobavezan rok valjanosti, a ključ nikada ne može stvoriti drugi ključ sa širim ovlastima od vlastitih.