/api/v1/access-grantsСъздаване на разрешение за достъп
Дайте на получател достъп до ограничената част от паспортите си по същите правила като в таблото: ролята определя кои точки от данните показва разрешението, разрешението за купувач назовава паспортите, които покрива, и приключва при смяна на собственика на батерията, а компания има най-много 50 активни разрешения.
Токенът pa_ се връща веднъж, в този 201, и повече никога. Съхранява се само хеш. Предайте го веднага на получателя и не го записвайте в логове. Идемпотентно повторение (същият Idempotency-Key, същото тяло) връща разрешението без токена и с tokenDelivered: true, така че хранилището за идемпотентност никога не съдържа удостоверение. Ако токенът е изгубен, отнемете разрешението и създайте ново. Полето notice казва същото в отговора.
Ролите на органи остават в таблото. market_surveillance, notified_body, commission и customs, както и нивото authority при ролята other, връщат 400 role_dashboard_only. Дневникът на достъпа записва кой API ключ или приложение е създало разрешението.
Кой може да го извика. API ключ само когато собственикът му е включил „May manage access grants“ за този ключ на страницата Developer (по подразбиране изключено; иначе 403 access_grants_not_enabled). OAuth токен изисква scope access_grants:write и потребител admin или owner. Изисква платен акаунт. Брои се като едно v1 записване.
Хедъри
- 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.
Полета в тялото
- roleзадължително
string
Ролята на получателя:
repairer,remanufacturer,repurposer,recycler,waste_treatment,training_centre,purchaser,purchaser_agent,elv_treatment,weee_treatmentилиother. Четирите роли на органи се отхвърлят. - labelзадължително
string (1-120 chars)
За кого е разрешението, както искате да го виждате.
- scope
object
{ "kind": "company" },{ "kind": "products", "ids": [...] }или{ "kind": "passports", "ids": [...] }(до 500 id, всички във вашата компания). Разрешението за купувач трябва да изброява паспорти. - purpose
string (max 500 chars)
Защо получателят получава достъп.
- evidence
object
{ type, reference, note? }, къдетоtypeеregister_entry,invoice,authority_letter,contractилиother. Записва се, не се проверява. - expiresInDays
integer | null (1-1825)
Дни до изтичане. Пропуснете за стандарта на ролята (12 месеца; без за купувач, чието разрешение приключва при смяна на собственика).
null= без изтичане.
Заявка
curl -sS -X POST https://app.tracepass.eu/api/v1/access-grants \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"role": "purchaser",
"label": "Buyer GmbH, order 4711",
"scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] }
}'Отговор
{
"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",
"token": "pa_REDACTED_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"notice": "Pass this token to the recipient now. It cannot be shown again: only a hash is stored, and neither the list nor an idempotent replay returns it."
}