TracePass
Разрешения за достъп

Промяна на разрешение за достъп

Променете етикета, целта, доказателството, срока или обхвата на активно разрешение. Изпратете само ключовете, които искате да промените, поне един. Ролята не може да се сменя: отнемете разрешението и създайте ново. Разрешение на орган (роля на орган или ниво authority) може да се променя само в таблото: през API връща 400 role_dashboard_only.

PATCH/api/v1/access-grants/{id}
Изтегли OpenAPI 3.1
PATCH/api/v1/access-grants/{id}

Промяна на разрешение за достъп

Променете етикета, целта, доказателството, срока или обхвата на активно разрешение. Изпратете само ключовете, които искате да промените, поне един. Ролята не може да се сменя: отнемете разрешението и създайте ново. Разрешение на орган (роля на орган или ниво authority) може да се променя само в таблото: през API връща 400 role_dashboard_only.

Преместването на срока на изтекло разрешение напред го прави отново активно и важи лимитът от 50 активни разрешения, както при създаване. Отнето разрешение връща 404. Промяната се записва в дневника на достъпа с API ключа или приложението, което я е направило.

Кой може да го извика. API ключ само когато собственикът му е включил „May manage access grants“ за този ключ на страницата Developer (по подразбиране изключено; иначе 403 access_grants_not_enabled). OAuth токен изисква scope access_grants:write и потребител admin или owner. Изисква платен акаунт. Брои се като едно v1 записване. Поддържа Idempotency-Key.

Параметри в пътя

  • idзадължително

    string (24 hex chars)

    ID на разрешението за достъп.

Хедъри

  • Authorizationзадължително

    string

    Bearer <token> — или tp_ API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4.

Полета в тялото

  • label

    string (1-120 chars)

    Нов етикет.

  • purpose

    string (max 500 chars)

    Нова цел.

  • scope

    object

    Нов обхват, същата форма като при създаване. Разрешението за купувач трябва да остане за паспорти.

  • evidence

    object

    Ново доказателство { type, reference, note? }.

  • expiresInDays

    integer | null (1-1825)

    Дни от сега до изтичане; null = без изтичане.

Заявка

curl -sS -X PATCH https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "expiresInDays": 90 }'

Отговор

{
  "data": {
    "id": "6650c1d2e3f4a5b6c7d8e9f0",
    "accessLevel": "restricted",
    "label": "Buyer GmbH, order 4711",
    "role": "purchaser",
    "scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] },
    "purpose": null,
    "evidence": null,
    "state": "active",
    "expiresAt": null,
    "useCount": 0,
    "createdAt": "2026-06-01T09:30:00.000Z"
  }
}