Postavite i upotrebljavajte Canva administratorski API

API za administratore Canva možete upotrebljavati za automatizaciju upravljanja organizacijom iz vlastitih sustava. Upravljajte korisnicima, timovima, grupama i članstvima te dohvaćajte događaje iz zapisnika o reviziji, bez potrebe da te zadatke ručno obavljate u Canvi.

• Dostupno za tarife Canva Enterprise, Canva Districts i Canva za sveučilišta.
• Dostupno administratorima tvrtke/ustanove.
• Dostupno organizacijama s jednim ili više timova.

Prije postavljanja API-ja za administratore provjerite ispunjava li vaša organizacija sljedeće preduvjete:

• Razina organizacije: API za administratore odnosi se na cijelu organizaciju. Dostupan je organizacijama s jednim ili više timova koje imaju tarife Canva Enterprise, Canva Districts i Canva Campus.
• Račun administratora tvrtke/ustanove: Samo administratori tvrtke/ustanove mogu izraditi klijente API-ja za administratore i upravljati njima u postavkama Canve.
• Interni ili vanjski razvojni resursi: Vaša organizacija treba razvojne resurse za izradu i održavanje integracije. Canva ne pruža podršku za implementaciju.
  • Ako vaš tim ne može izraditi integraciju s API-jem, dodjela resursa putem SCIM-a bolji je izbor za automatizaciju upravljanja korisnicima u vašoj organizaciji.
• Poznavanje strukture vaše organizacije u Canvi: Prije izrade integracije jasno utvrdite kako su vaša organizacija, timovi i grupe postavljeni u Canvi.
• Višefaktorska autentifikacija (MFA) ili račun kojim se upravlja putem jedinstvene prijave: Administrator tvrtke/ustanove koji konfigurira API za administratore mora imati uključenu MFA ili račun kojim se upravlja putem jedinstvene prijave. Računom mora upravljati organizacija u čije ime administrator djeluje ili ta organizacija mora biti njegov vlasnik.

API za administratore nudi krajnje točke za:

• Korisnike, timove i grupe: izradu, pregled, ažuriranje i brisanje.
• Članstva: dodavanje osoba u timove i grupe ili njihovo uklanjanje te dodjelu uloga.
• Zapisnike o reviziji: dohvaćanje događaja iz zapisnika o reviziji prema rasporedu.
• Pozivnice za timove: pozivanje osoba u tim (uključujući osobe izvan vaše organizacije), pregled pozivnica na čekanju, dohvaćanje postojeće veze za pozivnicu prema točnoj adresi e-pošte i otkazivanje pozivnica.

Administrator tvrtke/ustanove izrađuje klijenta API-ja za administratore i upotrebljava ga za slanje API poziva.

Slijedite dokumentaciju za API za administratore Canva da biste zamijenili vjerodajnice klijenta za token za pristup i počeli slati API zahtjeve.

Tehničke pojedinosti o autentifikaciji API zahtjeva i upotrebi prijenosnih tokena OAuth 2.0 podijelite sa svojim razvojnim timom putem dokumentacije za autentifikaciju API-ja za administratore Canva.

Radnje izvršene putem API-ja za administratore bilježe se uz klijenta API-ja za administratore, a ne uz pojedinačnog administratora koji je pozvao klijenta.

U zapisnicima o reviziji polje Actor prikazuje naziv i ID klijenta API-ja za administratore. Tako možete utvrditi koja je integracija izvršila neku radnju.

Možete utvrditi i koji je administrator tvrtke/ustanove izradio, ažurirao ili izbrisao određeni klijent API-ja.

Više informacija potražite u članku O zapisnicima o reviziji Canva.

Administratori tvrtke/ustanove mogu se koristiti API-jem za administratore za pozivanje osoba u tim, uključujući vanjske suradnike izvan vaše organizacije.

Važno je znati

• Svaka pozivnica koju izradite namijenjena je jednom timu i jednoj adresi e-pošte.
• Svaku pozivnicu možete iskoristiti samo jednom, a istječe nakon 30 dana.
• Ovisno o postavkama, Canva možda neće automatski poslati e-poruku pozvanoj osobi. Ako je potrebno, pošaljite joj vezu za pozivnicu izravno.
• Veze za pozivnice čuvajte u tajnosti. Veza za pozivnicu funkcionira samo za adresu e-pošte za koju je izrađena.
• Postojeće postavke pozivnica i domena vašeg tima i dalje se primjenjuju na osobe koje pozovete.
• Ako za pozvanu osobu već postoji pozivnica na čekanju, izradom nove pozivnice dobit ćete isti zapis pozivnice, s rokom valjanosti produljenim na 30 dana od zahtjeva i ažuriranom ulogom na zatraženu ulogu.

Pojedinosti o krajnjim točkama potražite u dokumentaciji za API za administratore Canva.

I API za administratore i SCIM mogu se upotrebljavati za dodjelu resursa korisnicima.

API za administratore podržava i upravljanje organizacijom Canva koje nadilazi dodjelu resursa korisnicima. To uključuje timove, grupe, članstva i zapisnike o reviziji.

SCIM podržava standardnu dodjelu i ukidanje dodjele resursa. Ako vam treba samo standardna dodjela resursa korisnicima ili vaš tim ne može izraditi prilagođenu API integraciju, SCIM je bolji izbor za vaše potrebe.

Treba li mojoj organizaciji razvojni inženjer za upotrebu API-ja za administratore?

Da. Za API za administratore vaša organizacija mora imati interne ili vanjske razvojne resurse za izradu i održavanje integracije. Canva ne pruža podršku za implementaciju. Ako vaš tim ne može izraditi integraciju s API-jem, dodjela resursa putem SCIM-a bolji je izbor za automatizaciju upravljanja korisnicima u vašoj organizaciji.

Treba li svima u mojoj organizaciji MFA ili jedinstvena prijava za upotrebu API-ja za administratore?

Ne. Samo administrator tvrtke/ustanove koji konfigurira API za administratore mora imati uključenu MFA ili račun kojim se upravlja putem jedinstvene prijave. Računom mora upravljati organizacija u čije ime administrator djeluje ili ta organizacija mora biti njegov vlasnik. Ostali članovi organizacije ne trebaju MFA ni jedinstvenu prijavu da bi API za administratore funkcionirao.

Može li moja organizacija pozivati vanjske suradnike putem API-ja za administratore?

Da. Administratori tvrtke/ustanove mogu se koristiti API-jem za administratore za pozivanje osoba u timove, uključujući vanjske suradnike. Postojeće postavke pozivnica i domena vašeg tima i dalje se primjenjuju na osobe koje pozovete.

Možemo li ponovno dohvatiti postojeću vezu za pozivnicu bez izrade nove pozivnice?

Da. Postojeću vezu za pozivnicu možete dohvatiti pomoću točne adrese e-pošte pozvane osobe, bez izrade nove pozivnice.