Interconnect.API
Za jednostavnu integraciju s vašim ERP ili EDI sustavima, razvili smo Interconnect.API (RESTful API) koji omogućuje slanje i primanje dokumenata izravno iz tih sustava. Kako bi razmjena dokumenata bila što brža, Interconnect koristi webhookove. Interconnect.Webhooks automatski obavještavaju API primatelja čim se dokument pošalje, omogućujući mu automatsko preuzimanje poslanog dokumenta.
Autorizacija
Za autorizaciju vaših zahtjeva prema Interconnect.API, koristimo OAuth 2.0 protokol s Bearer tokenima.
Kako doći do Bearer tokena?
Pošaljite HTTP POST zahtjev na adresu za dohvat tokena:
Okruženje | Adresa |
---|---|
Testno |
|
Produkcijsko |
|
Content-Type zahtjeva treba biti: application/x-www-form-urlencoded
Parametri zahtjeva
grant_type:
"password"
client_id: vaš jedinstveni ID klijenta
client_secret: vaša tajna klijenta
username: vaše korisničko ime
password: vaša lozinka
scope:
"Tomsoft.Interconnect.Api"
Primjer zahtjeva
POST https://identity.luceed.dev/connect/token
Content-Type: application/x-www-form-urlencoded
grant_type=password&client_id=VAŠ_CLIENT_ID&client_secret=VAŠ_CLIENT_SECRET&username=VAŠ_USERNAME&password=VAŠ_PASSWORD&scope=Tomsoft.Interconnect.Api
Primanje Bearer tokena
Nakon slanja ovog zahtjeva, dobit ćete odgovor u JSON formatu koji sadrži access token kojim ćete autorizirati API poziv. Valjanost tokena je kratka pa ga treba dohvaćati prije svakog novog poziva.
Primjer odgovora
{
"access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjQ1MTA4RjA5RUNFMkE3...",
"expires_in": 60,
"token_type": "Bearer",
"scope": "Tomsoft.Interconnect.Api"
}
Slanje zahtjeva s Bearer tokenom
Kada imate Bearer token, jednostavno ga dodajte u zaglavlje svakog HTTP zahtjeva prema Interconnect.API na sljedeći način.
Primjer zahtjeva s Bearer tokenom
POST https://interconnect.luceed.dev/api/documents
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjQ1MTA4RjA5RUNFMkE3...
Content-Type: application/json
{
"DocumentSenderId": "[NA:1234,7531]",
"DocumentType": "UBL:ORDER",
"DocumentFormat": "XML",
"DocumentTransformation": "base64",
"DocumentContent": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTg..."
}
Interconnect.API dokumentacija
Interconnect.API dokumentaciji možete pristupiti ovdje: