Vytvorenie aktivity

Tento koncový bod vám umožňuje automatizovať proces vytvárania aktivít v aplikácii Beenia prostredníctvom integračných nástrojov. Môžete ho použiť na jednoduché vytváranie aktivít s definovanými parametrami a zabezpečiť, aby vaši používatelia mali aktuálne informácie o svojich úlohách a aktivitách.

Žiadosť

• Metóda: PRÍSPEVOK
• Cesta: /external/v0/zapier/webhooks/aktivity
• hlavička:

• KĽÚČ X: Kľúč API pre autentifikáciu.

• Vstupný objekt (vo formáte JSON), ktorý obsahuje nasledujúce polia:

• názov(string): Názov činnosti.

• Povinné pole.

• popis(string): Popis činnosti.
• Id vlastníkovTeamID Identifikátor tímu, ku ktorému aktivita patrí. Ak je nastavená na hodnotu null, aktivita sa vytvorí v aktivitách TODO overeného používateľa.
• priorita(string): Priorita činnosti. Môže mať 3 hodnoty: „LOW“, „MEDIUM“ a „HIGH“.
• TagIDs (pole čísel): Identifikátory značiek priradených aktivite.
• DueDate(dátum a čas): Dátum splatnosti činnosti.
• ID sekcie(číslo): Identifikátor oddielu, v ktorom by sa mala činnosť umiestniť.

• Môže byť vyplnený iba vtedy, ak hodnota OwnerTeamID nie je nulová.

• SledovateľyIds (pole čísel): Identifikátory ľudí, ktorí sledujú aktivitu.

• Môže byť vyplnený iba vtedy, ak hodnota OwnerTeamID nie je nulová.

• PriradenéGoalids (pole čísel): Identifikátory cieľov priradených aktivite.

• Môže byť vyplnený iba vtedy, ak hodnota OwnerTeamID nie je nulová.

• GtDiD(číslo): Identifikátor projektu GTD (Getting Things Done).

• Môže byť vyplnený iba vtedy, ak je hodnota OwnerTeamID nula.

• ZadávanieIds (pole čísel): Identifikátory pridelených jednotlivcov.

• Môže byť vyplnený iba vtedy, ak hodnota OwnerTeamID nie je nulová.

Odpoveď

Po úspešnom vytvorení aktivity bude odpoveď vo formáte JSON obsahovať potvrdenie o vytvorení aktivity s nasledujúcimi informáciami:

{

„name“: „úloha testovania činnosti“,

„dueDate“: nula,

„externalID“: nula,

„ID“: 55503877,

„reportedState“: nula,

„cedent“: [],

„followers“: [],

„section“: null,

„tagy“: {

„6850": „značka1",

„6851": „značka2"

},

„state“: „OTVORENÉ“,

„ParentActivity“: null,

„CalcnumopenSubActivity“: 0,

„delete“: false,

„canban“: nula,

„lastModified“: „2023-09-18T 08:21:00.569 Z“,

„CalcKomentáre“: 0,

„SortOrder“: 5.000000239745E11,

„priority“: „STREDNÁ“,

„DelegationRootActivityID“: null,

„DelegationTargetActivityID“: null,

„DelegationTargetActivityIsActive“: false,

„CustomFields“: {},

„vlastník“: {

„ID“: 13450454,

„FullName“: „John Black“

},

„backgroundid“: nula,

„description“: "<p>Popis úlohy</p> „,

„nájomca“: 409,

„OwnerInfo“: null,

„OwnerTeam“: {

„ID“: 20500874,

„name“: „Testovací tím“

},

„CreatEdat“: „2023-09-18H 08:20:31.659 Z“,

„deleteDat“: null,

„DelegationRootActivityTeamID“: null,

„DelegationTargetActivityTeamID“: null

}

Popis atribútov:

• názov: Reťazec popisujúci názov úlohy alebo činnosti.
• DueDate: Toto pole obsahuje dátum, kedy je aktivita splatná.
• ExternalID: Toto pole obsahuje externý identifikátor činnosti, ak je k dispozícii.
• ID: Toto je jedinečný identifikátor činnosti v systéme.
• Nahlásený štát: Toto pole obsahuje nahlásený stav činnosti, ak je nahlásený.
• nadobúdateľ: Toto pole obsahuje priradených jednotlivcov alebo tímy k činnosti.
• sledovatelia: Toto pole obsahuje jednotlivcov, ktorí sledujú aktivitu.
• časť: Toto pole obsahuje informácie o sekcii, ku ktorej je aktivita priradená.
• štítky: Toto pole obsahuje značky priradené k aktivite. Každá značka je identifikovaná podľa svojho identifikátora a názvu.
• štát: Toto pole definuje stav činnosti. Môže byť „OTVORENÉ“ alebo „ZATVORENÉ“ v závislosti od toho, či je aktivita aktívna alebo uzavretá.
• Rodičovská aktivita: Toto pole obsahuje identifikátor nadradenej aktivity, ak je aktivita súčasťou hierarchie aktivít.
• CalcnumopenSubaktivity: Toto číslo označuje počet otvorených čiastkových činností, ktoré sú súčasťou tejto činnosti.
• vymazaný: Toto pole označuje, či je aktivita označená ako odstránená (true) alebo nie (false).
• kanban: Toto pole obsahuje informácie o stave činnosti.
• Naposledy upravené: Toto pole obsahuje dátum poslednej úpravy činnosti.
• priorita: Toto pole definuje prioritu činnosti. Priorita môže byť nastavená na „STREDNÁ“, „NÍZKA“ alebo „VYSOKÁ“, čo charakterizuje dôležitosť činnosti.
• DelegácieRootActivityID: Toto pole obsahuje identifikátor nadradenej aktivity, ak je aktivita súčasťou úloh delegovania.
• DelegáciaTargetActivityID: Toto pole obsahuje identifikátor cieľovej činnosti v rámci úloh delegovania.
• DelegáciaCieľAktivitaAktivitaAktivita: Toto pole označuje, či je cieľová aktivita v rámci úloh delegovania aktívna (true) alebo nie (false).
• CustomFields: Toto pole môže obsahovať ďalšie vlastné polia alebo informácie spojené s aktivitou.
• vlastník: Toto pole obsahuje informácie o vlastníkovi činnosti vrátane identifikátora a celého mena.
• spätnáGroundid: Toto pole obsahuje identifikátor pozadia priradeného k činnosti.
• popis: Toto pole obsahuje popis činnosti. Popis môže byť vo formáte HTML.
• nájomca: Toto pole obsahuje identifikátor nájomcu alebo organizácie spojenej s činnosťou.
• Vlastnícky tím: Toto pole obsahuje informácie o tíme vlastníka činnosti vrátane identifikátora a názvu tímu.
• CreateDat: Toto pole obsahuje dátum a čas vytvorenia činnosti.
• OdstrániteDat: Toto pole obsahuje dátum a čas vymazania aktivity, ak je odstránená.
• DelegáciaRootActivityTeamID: Toto pole obsahuje identifikátor tímu nadradenej aktivity v rámci úloh delegovania.

‍