Mango API v1

Účel článku

Článek má za cíl zdokumentování Mango REST API v1. Dokumentaci postupně doplňujeme. API lze volat na produkční doméně https://is.cibs.cz nebo testovací https://test.cibs.cz.

Přihlášení, autorizace, autentikace

---

Vytvoření tokenu - POST /api/v1/session

Request parametry

Parametr	Popis
username	login operátora
password	heslo operátora
ct	id lokace

Response parametry

Parametr	Popis
backendLoginId	id operátora
logLevel	úroveň logování
ct	id lokace
token	autentizační token
atb

Příklad

curl -d username=$login -d password=$heslo -d ct=$ct https://is.cibs.cz/api/v1/session

---

Smazání tokenu - DELETE /api/v1/session

Příklad

curl -s -H "X-Session-Token:$token"  -X DELETE "https://is.cibs.cz/api/v1/session/$token"

Pokud by se vyskytla chybová hláška obsahující error ohledně sady šifer, lze k tomuto příkazu přidat parametr --ciphers DEFAULT@SECLEVEL=1.

Uživatelé (users)

---

Export zákazníků - GET /api/v1/users

Práva a nastavení

Popis práv a možnosti hodnot najdete pod odkazem.

Název
USER_LIST.EXPORT
CT

Request parametry

Parametr	Popis
limit	počet záznamů načítaných jedním voláním
offset	index prvního záznamu v případě postupného načítání (viz limit)
userId	id existujícího zákazníka (vrací pouze 1 záznam k tomuto id)
agreementName	Číslo smlouvy existujícího zákazníka (vrací pouze záznamy k tomuto číslu)

Response parametry

Parametr	Popis
houseId	adresa sídla/trvalého bydliště - číslo popisné
city	adresa sídla/trvalého bydliště - obec
zip	adresa sídla/trvalého bydliště - PSČ
street	adresa sídla/trvalého bydliště - ulice
accountBank	číslo banky bankovního spojení
documentNumber	číslo dokladu
agreementName	číslo smlouvy
accountNumber	číslo účtu bankovního spojení
dateTimeTest	datum aktivace
dayOfBirth	datum narození
dateTest	datum narození
companyFid	DIČ
mailingAddressHouseId	doručovací adresa - číslo popisné
mailingAddressZip	doručovací adresa - IČO
mailingAddressCity	doručovací adresa - obec
mailingAddressRecipient	doručovací adresa - příjemce
mailingAddress	doručovací adresa - shodná s adresou sídla/trvalého bydliště nebo vlastní "AS1"/"OWN"
mailingAddressStreet	doručovací adresa - ulice
emails	emaily
billingAddressHouseId	fakturační adresa - číslo popisné
billingAddressCity	fakturační adresa - obec
billingAddressRecipient	fakturační adresa - příjemce
billingAddressZip	fakturační adresa - PSČ
billingAddress	fakturační adresa - shodná s adresou sídla/trvalého bydliště nebo shodná s doručobvací adresou nebo vlastní "AS1"/"AS2"/OWN"
billingAddressStreet	fakturační adresa - ulice
fax	faxové číslo
accountIban	IBAN bankovního spojení
companyVatId	IČ DPH
companyId	IČO
codeReference	ID doporučujícího zákazníka
id	id zákazníka
firstName	jméno
infoEmail	komunikační kanál email
infoPost	komunikační kanál pošta
infoSms	komunikační kanál sms
codeName	kódové označení
vatRegistered	plátce daně
accountPreNumber	předčíslí bankovního spojení
login	přihlašovací jméno
lastName	příjmení
premises	příznak evidence provozven
personalNumber	rodné číslo
U_BP_IDS	seznam id povolených billing plánů
groupCompanyFid	skupinové DIČ
infoMarketing	souhlas se zasíláním marketingových sdělení
accountSpecSym	specifický symbol bankovního spojení
sipo	spojovací šíslo SIPO
companyName	společnost
statutary	statutární orgán
active	stav zákazníka (-1 neaktivní trvale/0 neaktivní dočasně/1 aktivní)
phones	telefonní čísla
degreeBehind	titul před jménem
degree	titul za jménem
providerType	typ poskytovatele "DEFAULT_PROVIDER"/"NONE"/"PROVIDER"
type	typ zákazníka (soukromá/fyzická/právnická)
accountVarSym	variabilní symbol
valuation	zhodnocení zákazníka

Příklad

#export všech zákazníků v jednom bloku
curl -v -H "X-Session-Token:$token" https://is.cibs.cz/api/v1/users

#export všech zákazníků po blocích
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/users?limit=10&offset=0"
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/users?limit=10&offset=10"
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/users?limit=10&offset=20"
...

#export 1 zákazníka s id 123456
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/users?userId=123456"

#export 1 zákazníka s č. smlouvy 123456
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/users?agreementName=123456"

---

Procesy (processes)

Seznam procesů - GET /api/v1/processes

Práva a nastavení

Popis práv a možnosti hodnot najdete pod odkazem.

Název
CT

Request parametry

Parametr	Popis
limit	počet záznamů načítaných jedním voláním
offset	index prvního záznamu v případě postupného načítání (viz limit)
state	Název stavu procesů.
activeOnly	Filtr pouze aktivních (neukončených) procesů.
typeId	Id typ procesu. Může být zadáno i více hodnot, pak se zadají jako čárkou oddělený seznam.
userId	Id zákazníka na kterého jsou evidovány procesy.
unit	Id jednotky na kterou jsou navázány procesy.
dateFrom	Datum (a čas) zahájení procesu je větší nebo rovno než zadaná hodnota. Hodnota se zadává ve formátu YYYY-MM-DD [hh:mm:ss].
dateTo	Datum (a čas) zahájení procesu je menší nebo rovno než zadaná hodnota. Hodnota se zadává ve formátu YYYY-MM-DD [hh:mm:ss].
lastActivityFrom	Datum (a čas) poslední aktivity v procesu je větší nebo rovno než zadaná hodnota. Hodnota se zadává ve formátu YYYY-MM-DD [hh:mm:ss].
lastActivityTo	Datum (a čas) poslední aktivity v procesu je menší nebo rovno než zadaná hodnota. Hodnota se zadává ve formátu YYYY-MM-DD [hh:mm:ss].
PARAM_NAME	Je možné filtrovat pomocí jakéhokoliv uživatelsky definovaného parametru procesu. Název parametru se zapisuje velkými písmeny.

Response parametry

Parametr	Popis
id	Id procesu
typeId	Id typu procesu
typeName	Název typu procesu. Příklad: "Proces"
stateName	Název stavu procesu. Příklad: "Nahlášeno"
name	Název procesu
description	Popis procesu
priorityName	Název priority
startTime	Datum a čas zahájení procesu. Příklad: "2024-05-04T13:55:42+02:00"
lastActivity	Datum a čas poslední aktivity v procesu. Příklad: "2024-05-04T13:55:46+02:00"
userId	Id uživatele přiřazeného k procesu
unreadMessages	Počet nepřečtených zpráv v chatu. Je relevantní jen u procesů používajících chat
warning	Počet warování chatu. Je relevantní jen u procesů použíajících chat
editable	Příznak editovatelnosti procesu uživatelem (podle práv, stavu procesu, atd.)
PARAM_NAME	Všechny uživatelsky definované parametry procesu jsou uvedeny velkými písmeny. Pro každý parametr je jeden parametr response. Příklad: "MY_PARAM" = "Hodnota_1234"
transitions	Seznam (pole) všech dostupných přechodů stavu procesu. Vychází z aktuálního stavu procesu a práv uživatele.

Příklad

# získání seznamu všech procesů v jednom bloku
curl -v -H "X-Session-Token:$token" https://is.cibs.cz/api/v1/processes

# získání seznamu všech procesů po stránkách
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/processes?limit=10&offset=0"
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/processes?limit=10&offset=10"
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/processes?limit=10&offset=20"
...

# získání seznamu všech procesů s uživatelkým filtrem času zahájení procesu větším než
curl -v -H "X-Session-Token:$token" "https://is.cibs.cz/api/v1/processes?dateFrom="2024-05-01"

---

Zpět na:

• Rozhraní API