Публикуваният паспорт показва публичните си полета на всички. Другите полета са ограничени до страните, които се нуждаят от тях: лице, извършващо ремонт, рециклиращо предприятие, купувач, орган за надзор на пазара. Операторът дава на такава страна разрешение за достъп, токен pa_, а страната го представя, когато чете паспорта. Тази страница описва какво изпраща притежателят и какво получава.
Четене на паспорт с разрешение
Изпратете разрешението до собствения адрес на паспорта, този, към който сочи QR кодът, по един от два начина: като Authorization: Bearer pa_… или като параметър на заявката ?access=pa_…. Заглавката Bearer е подходяща за програми, а параметърът — за връзка, но URL остава в историята на браузъра и в дневниците на сървъра, затова предпочитайте заглавката, където можете. Разрешението важи за страницата на паспорта и за изгледите JSON-LD, PDF, EPCIS и данни.
curl -H "Authorization: Bearer pa_REDACTED_xxxxxxxxxxxx" \
-H "Accept: application/ld+json" \
https://id.tracepass.eu/01/99999999999997/21/6B27A0000001Същата заявка с параметъра:
https://id.tracepass.eu/01/99999999999997/21/6B27A0000001?access=pa_REDACTED_xxxxxxxxxxxxТокенът pa_ служи за четене на публикуван паспорт. Той не удостоверява извикванията към /api/v1, които приемат API ключ tp_ или OAuth. Разрешение, което е неизвестно, изтекло, отнето или не покрива този паспорт, не се отхвърля: заявката получава публичния изглед, сякаш не е изпратено разрешение.
Какво позволява разрешението да видите
Операторът издава всяко разрешение на наименувана роля: лице, извършващо ремонт, повторно производство или пренасочване, рециклиращо предприятие, оператор по третиране на отпадъци, център за обучение, купувач или негов представител, съоръжение за третиране на излезли от употреба превозни средства или на ОЕЕО, орган за надзор на пазара, нотифициран орган, Комисията, митница или друга. То е в обхват на цялата компания, избрани продукти или избрани паспорти. Ролите на органи виждат цялото си ниво.
При батериите ролята определя кои данни по приложение XIII вижда притежателят: лицето, извършващо ремонт, вижда данните за резервни части и демонтаж, купувачът — данните на батерията, която е купил, и така нататък. Съответствието следва проекта на акт за изпълнение на Комисията по член 77, параграф 9 от Регламента за батериите. Този акт не е приет и проектът може да се промени, затова приемайте съответствието като предварително.
Поле, което ролята не покрива, не се пропуска мълчаливо. Изгледът на паспорта го показва като „Не е част от този достъп“ (на езика на изгледа), така че притежателят може да различи поле, скрито от разрешението, от поле, което паспортът не съдържа. Данните извън полетата, като произход, история на обслужването и събития EPCIS, следват същото правило.
Срок и дневник на четенията
Разрешението изтича по подразбиране след 12 месеца. Разрешението на купувача няма срок и приключва, когато бъде записана промяна на собственика на батерията. Операторът може да отнеме всяко разрешение по всяко време. При издаването му се записват целта и доказателствата, които операторът е проверил. Тези доказателства се записват, но не се проверяват: TracePass не проверява самоличността на притежателя.
Всяко четене, което връща съдържание чрез разрешение, се записва и се брои по разрешение, паспорт, канал (страница, JSON-LD, PDF, EPCIS, данни) и ден. Дневникът не съдържа IP адрес.
Кеширане
Отговорът към разрешение е Cache-Control: private, no-store с Vary: Authorization. Не го кеширайте в споделен кеш и не го предавайте нататък: съдържа данни, които публичният изглед не съдържа.