Разрешения за достъп
Споделяйте ограничени данни от паспорта с купувач, сервиз или рециклатор и ги отнемайте: създаване, списък, промяна, отнемане и дневник на достъпа.
/api/v1/access-grantsСъздаване на разрешение за достъп
Дайте на получател достъп до ограничената част от паспортите си по същите правила като в таблото: ролята определя кои точки от данните показва разрешението, разрешението за купувач назовава паспортите, които покрива, и приключва при смяна на собственика на батерията, а компания има най-много 50 активни разрешения.
/api/v1/access-grantsСписък на разрешенията за достъп
Разрешенията за достъп на компанията, най-новите първи, с курсор. Разрешението е удостоверението, с което получателят (купувач, сервиз, рециклатор) чете ограничената част от паспорта. Списъкът никога не връща токен, нито част от него.
/api/v1/access-grants/{id}Четене на разрешение за достъп
Едно разрешение на вашата компания — активно, изтекло или отнето. Полето `state` казва кое. Отговорът никога не съдържа токена, нито част от него.
/api/v1/access-grants/{id}Промяна на разрешение за достъп
Променете етикета, целта, доказателството, срока или обхвата на активно разрешение. Изпратете само ключовете, които искате да промените, поне един. Ролята не може да се сменя: отнемете разрешението и създайте ново. Разрешение на орган (роля на орган или ниво authority) може да се променя само в таблото: през API връща `400 role_dashboard_only`.
/api/v1/access-grants/{id}Отнемане на разрешение за достъп
Отнемете разрешение: токенът му спира да работи веднага. Идемпотентно: отнемане на вече отнето разрешение връща пак `200` с него. Само id, което не е на вашата компания, връща `404`. Разрешение на орган (роля на орган или ниво authority) може да се отнема само в таблото: през API връща `400 role_dashboard_only`.
/api/v1/access-grants/{id}/activityДневник на достъпа на разрешение
Редовете от дневника на разрешението, най-новите първи, с курсор. Събитията (`grant_created`, `grant_changed`, `grant_revoked`) назовават кой е действал: `via` е API ключът (по етикета му) или OAuth приложението и е `null` за таблото; `actorId` е потребителят, за когото е действано. Редовете `read` носят по един брой на паспорт, канал и ден.