# Jegyek létrehozása más rendszerekből a Todomator API-val

> Hitelesítsd magad a Todomator tokenjével, és hozz létre jegyet egyetlen JSON hívással, szkriptből, e-mailből vagy webes űrlapról, mappákkal, személyekkel, címkékkel, mellékletekkel és callbackkel.

Framework: todomator
Product: Todomator (todomator@1.7)
Language: hu
Content-SHA256: 0e3d753f6602f6e48d1935c46e9fe561df2547e515a319caf528210cbe17bfbc
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: 
Review: not-recorded

A Todomator a műveleteit egyetlen API végponton keresztül teszi elérhetővé: `POST /api/` JSON törzzsel `{ "schema": "<name>", "data": { ... } }` (a Total.js API útvonalai; lásd a [API útvonalak](/en/total5/api-routes/) receptet). Az `/api/` cím a `config` fájl `$api` sorából jön.

## Hitelesítés tokennel

A bejelentkezett személy munkamenete mellett az API elfogad egy **tokent**: küldd az `x-token` fejlécben vagy a `token` lekérdezési paraméterben. Ha megegyezik a `token` beállítással (lásd [beállítások](/en/todomator/settings-and-database/)), a kérés egy *Bot* nevű beépített felhasználóként fut, amely `bot` jogosultságú adminisztrátor; bármely más tokent elutasít. Használj hosszú véletlen tokent, tartsd a szervereden, és csak HTTPS-en küldd.

## Jegy létrehozása

A hívás neve `tickets_create`. Csak a `name` kötelező; a többi opcionális:

| Mező | Megjegyzések |
|---|---|
| `name` | a cím |
| `folder` vagy `folderid` | a mappa **név** szerint (a Todomator megkeresi) vagy azonosító szerint; a jegy átveszi a mappa számlázható jelzőjét |
| `users` | a hozzárendelendő személyek **név vagy e-mail** szerint; az ismeretlen személy hiba (`User "..." not found`) |
| `watcherid` | a követő személyek **azonosító** szerint (a `users` mezővel ellentétben ennek a verziónak a sémája név szerint nem fogadja el őket) |
| `statusid` | `pending` (alapértelmezett), `open`, `review`, `postponed`, `note` vagy `closed` |
| `markdown`, `html` | a tartalom |
| `tags`, `ispriority`, `isbillable`, `ispublic` | címkék és jelzők |
| `date`, `deadline`, `worked` | a nap, egy határidő és a már ledolgozott percek |
| `attachments` | `{ name, data }` elemek listája, ahol a `data` a fájl Base64-ben |
| `reference`, `source`, `attrs` | szabad mezők a jegy és a te rendszered összekapcsolásához |
| `callback` | egy cím, amely megkapja a jegyet |

```json
{
	"schema": "tickets_create",
	"data": {
		"name": "The invoice page fails with a 500",
		"folder": "Customer support",
		"users": ["jane@example.com"],
		"markdown": "Reported by the contact form.\n\nSteps: open the invoice and click *Print*.",
		"tags": ["bug"],
		"source": "website",
		"reference": "form-2041"
	}
}
```

A válasz az új jegy azonosítója. A hozzárendelt személyek értesítést kapnak, és frissülnek azoknak a nyitott munkamenetei, akik láthatják.

## A callback

Ha a `callback` be van állítva, a Todomator `POST` kérést küld arra a címre a jegy adataival, amikor a jegyet létrehozzák, frissítik vagy klónozzák, és amikor megjegyzést adnak hozzá (létrehozáskor és frissítéskor a megadott mezők listáját is elküldi, `keys`). A rendszered ezzel tükrözheti a jegy állapotát.

## További hívások

Ugyanez a végpont szolgálja ki a többi műveletet a `controllers/api.js` neveivel: `tickets` (lista), `tickets_detail/{id}`, `tickets_update/{id}`, `tickets_clone/{id}`, `tickets_remove/{id}`, `logwork_create`, `folders`, `tags` és továbbiak. A hivatalos API-dokumentáció a [docs.totaljs.com/todomator](https://docs.totaljs.com/todomator/) címen található.