Postavite i upotrebljavajte Canva administratorski API

Canva Admin API možete upotrebljavati za automatizaciju upravljanja ustanovom iz vlastitih sustava. Upravljajte korisnicima, timovima, grupama i članstvima te dohvaćajte događaje iz zapisnika o reviziji bez ručnog obavljanja tih zadataka u Canvi.

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

Prije postavljanja Admin API-ja provjerite ispunjava li vaša tvrtka/ustanova sljedeće preduvjete:

• Razina tvrtke/ustanove: Admin API namijenjen je tvrtkama/ustanovama. Dostupan je tvrtkama/ustanovama s jednim ili više timova koje imaju plan Canva Enterprise, Canva Districts ili Canva za sveučilišta.
• Račun administratora tvrtke/ustanove: Samo administratori tvrtke/ustanove mogu izraditi i upravljati klijentima Admin API-ja u postavkama Canve.
• Interni ili vanjski inženjerski resursi: Vaša tvrtka/ustanova treba inženjerske resurse za izradu i održavanje integracije. Canva ne pruža podršku pri implementaciji.
  • Ako vaš tim ne može izraditi integraciju putem API-ja, dodjela resursa putem SCIM-a prikladnija je za automatizaciju upravljanja korisnicima u vašoj tvrtki/ustanovi.
• Poznavanje strukture vaše tvrtke/ustanove u Canvi: Prije izrade integracije dobro proučite kako su vaša tvrtka/ustanova, timovi i grupe postavljeni u Canvi.
• Račun kojim se upravlja putem višefaktorske provjere autentičnosti (MFA) ili jedinstvene prijave (SSO): Administrator tvrtke/ustanove koji konfigurira Admin API mora imati omogućenu višefaktorsku provjeru autentičnosti (MFA) ili račun kojim se upravlja putem jedinstvene prijave (SSO). Računom mora upravljati tvrtka/ustanova koju administrator predstavlja ili ona mora biti njegov vlasnik.

Admin API omogućuje sljedeće radnje:

• Korisnici, timovi i grupe: izrada, pregled, ažuriranje i brisanje.
• Članstva: dodavanje ili uklanjanje osoba iz timova i grupa te postavljanje njihovih uloga.
• Zapisnici o reviziji: dohvaćanje događaja iz zapisnika o reviziji prema rasporedu.
• Pozivnice za tim: pozivanje osoba u tim (uključujući osobe izvan vaše tvrtke/ustanove), pregled pozivnica na čekanju, dohvaćanje postojeće poveznice za pozivnicu pomoću točne adrese e-pošte i otkazivanje pozivnica.

Administrator tvrtke/ustanove izrađuje klijenta Admin API-ja i upotrebljava ga za slanje zahtjeva API-ju.

Slijedite dokumentacija za Canva Admin API da biste zamijenili vjerodajnice klijenta tokenom za pristup i počeli slati API zahtjeve.

Tehničke pojedinosti o provjeri autentičnosti API zahtjeva i upotrebi OAuth 2.0 tokena nositelja potražite u dokumentaciji za provjeru autentičnosti za Canva Admin API i podijelite je sa svojim inženjerskim timom.

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

U zapisnicima o reviziji u polju Actor prikazuju se naziv i ID klijenta Admin API-ja. Tako možete prepoznati integraciju koja je izvršila neku radnju.

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

Dodatne informacije potražite u odjeljku O zapisnicima o reviziji u Canvi.

Administratori tvrtke/ustanove mogu putem Admin API-ja pozivati osobe u tim, uključujući vanjske suradnike izvan vaše tvrtke/ustanove.

Dobro je znati

• Svaka pozivnica koju izradite odnosi se na jedan tim i jednu adresu e-pošte.
• Svaku pozivnicu možete upotrijebiti samo jednom, a ističe nakon 30 dana.
• Ovisno o postavkama, Canva možda neće automatski poslati e-poštu pozvanoj osobi. Ako je potrebno, izravno joj pošaljite poveznicu na pozivnicu.
• Poveznice na pozivnice čuvajte kao privatne. Poveznica na 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 vraća se isti zapis pozivnice, rok valjanosti ponovno se postavlja na 30 dana od zahtjeva, a uloga u pozivnici ažurira se na zatraženu ulogu.

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

I Admin API i SCIM podržavaju dodjelu korisničkih resursa.

Admin API omogućuje upravljanje tvrtkom/ustanovom u Canvi koje nadilazi dodjelu korisničkih resursa. To uključuje timove, grupe, članstva i zapisnike o reviziji.

SCIM podržava standardnu dodjelu i ukidanje dodijeljenih resursa. Ako vam je potrebna samo standardna dodjela korisničkih resursa ili vaš tim ne može izraditi prilagođenu integraciju API-ja, SCIM je prikladniji za vaše potrebe.

Treba li mojoj tvrtki/ustanovi razvojni inženjer za upotrebu Admin API-ja?

Da. Za upotrebu Admin API-ja vašoj su tvrtki/ustanovi potrebni interni ili vanjski inženjerski resursi za izradu i održavanje integracije. Canva ne pruža podršku pri implementaciji. Ako vaš tim ne može izraditi integraciju putem API-ja, dodjela resursa putem SCIM-a prikladnija je za automatizaciju upravljanja korisnicima u vašoj tvrtki/ustanovi.

Treba li svima u mojoj tvrtki/ustanovi MFA ili jedinstvena prijava (SSO) za upotrebu Admin API-ja?

Ne. Samo administrator tvrtke/ustanove koji konfigurira Admin API mora imati omogućenu višefaktorsku provjeru autentičnosti (MFA) ili račun kojim se upravlja putem jedinstvene prijave (SSO). Računom mora upravljati tvrtka/ustanova koju administrator predstavlja ili ona mora biti njegov vlasnik. Ostali članovi tvrtke/ustanove ne trebaju MFA ni jedinstvenu prijavu (SSO) da bi Admin API funkcionirao.

Može li moja tvrtka/ustanova putem Admin API-ja pozvati vanjske suradnike?

Da. Administratori tvrtke/ustanove mogu putem Admin API-ja pozivati osobe 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 poveznicu na pozivnicu bez izrade nove pozivnice?

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