TracePass
Започнете
Паспорти

Проверка на готовността за регистъра

Връща дали паспорт би преминал **формалната проверка за подаване на EU DPP Registry** — `{ ready, findings[] }`. Това е *механичната* проверка на регистъра преди подаване, различна от и допълваща същинската оценка `/compliance`: паспорт може да е готов за регистъра, но да не е същински съответстващ, и обратно. Извикайте я преди подаване към регистъра, за да откриете формалните пропуски рано.

GET/api/v1/passports/{id}/registry-readiness
Изтегли OpenAPI 3.1
GET/api/v1/passports/{id}/registry-readiness

Проверка на готовността за регистъра

Връща дали паспорт би преминал **формалната проверка за подаване на EU DPP Registry** — `{ ready, findings[] }`. Това е *механичната* проверка на регистъра преди подаване, различна от и допълваща същинската оценка `/compliance`: паспорт може да е готов за регистъра, но да не е същински съответстващ, и обратно. Извикайте я преди подаване към регистъра, за да откриете формалните пропуски рано.

Три формални проверки, всяка носена на стандартната finding форма с `REG-READY-*` `ruleId`. **`REG-READY-MANDATORY`**: всяко задължително поле, приложимо за този тип батерия, е налично и одобрено — с отчитане на приложимостта, така че поле, неприложимо за категорията на батерията (напр. state-of-certified-energy за батерия, различна от EV), не се брои за липсващо, а поле с `unknown` приложимост се появява като warning, не като блокиране. **`REG-READY-FORMAT`**: попълнените полета са добре формирани (типове, enums, patterns, граници). **`REG-READY-LINK`**: публичният линк на паспорта се разрешава — жива проверка; при непубликуван паспорт това е предупредителен warning, а не блокиране, тъй като preflight-ът е предназначен да се изпълнява преди публикуване.

`ready` е `true` само когато няма critical findings; warnings никога не блокират готовността. **Само паспорти на батерии** в тази версия — паспорт, различен от батерия, връща `ready: true` с единствен `REG-READY-SCOPE` warning, тъй като формалната проверка на регистъра за други категории все още не е моделирана. Само за четене; брои се като едно v1 четене на паспорт спрямо дневния лимит.

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

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

    ObjectId

    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

Заявка

curl -sS \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registry-readiness \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "ready": false,
  "findings": [
    {
      "type": "missing_field",
      "severity": "critical",
      "target": "batteryUniqueIdentifier",
      "ruleId": "REG-READY-MANDATORY",
      "why": "A mandatory field that applies to this battery is missing.",
      "fix": "Provide batteryUniqueIdentifier before submitting to the registry."
    },
    {
      "type": "unverifiable_conditional",
      "severity": "warning",
      "target": "https://id.tracepass.eu/p/01/...",
      "ruleId": "REG-READY-LINK",
      "why": "This passport isn't published yet, so the registry link can't be checked live."
    }
  ]
}

Свързани endpoints