TracePass
Loslegen
Pässe

Registry-Bereitschaft des Passes prüfen

Liefert, ob ein Pass die **formale Einreichungsprüfung des EU DPP Registry** bestehen würde — `{ ready, findings[] }`. Dies ist die *mechanische* Vorabprüfung des Registry, verschieden von und ergänzend zum substanziellen `/compliance`-Urteil: Ein Pass kann Registry-bereit sein, ohne substanziell konform zu sein, und umgekehrt. Rufen Sie sie vor der Einreichung beim Registry auf, um formale Lücken früh zu erkennen.

GET/api/v1/passports/{id}/registry-readiness
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/registry-readiness

Registry-Bereitschaft des Passes prüfen

Liefert, ob ein Pass die **formale Einreichungsprüfung des EU DPP Registry** bestehen würde — `{ ready, findings[] }`. Dies ist die *mechanische* Vorabprüfung des Registry, verschieden von und ergänzend zum substanziellen `/compliance`-Urteil: Ein Pass kann Registry-bereit sein, ohne substanziell konform zu sein, und umgekehrt. Rufen Sie sie vor der Einreichung beim Registry auf, um formale Lücken früh zu erkennen.

Drei formale Prüfungen, jede auf der Standard-Finding-Form mit einer `REG-READY-*` `ruleId`. **`REG-READY-MANDATORY`**: Jedes Pflichtfeld, das auf diesen Batterietyp zutrifft, ist vorhanden und freigegeben — anwendbarkeitsbewusst, sodass ein Feld, das für die Batteriekategorie nicht zutrifft (z. B. State-of-Certified-Energy bei einer Nicht-EV-Batterie), nicht als fehlend gezählt wird und ein Feld mit `unknown`-Anwendbarkeit als Warning erscheint, nicht als Blocker. **`REG-READY-FORMAT`**: Ausgefüllte Felder sind wohlgeformt (Typen, Enums, Patterns, Grenzen). **`REG-READY-LINK`**: Der öffentliche Link des Passes löst auf — ein Live-Probe; bei einem unveröffentlichten Pass ist dies eine beratende Warning statt eines Blockers, da der Preflight vor dem Veröffentlichen laufen soll.

`ready` ist nur `true`, wenn es null kritische Findings gibt; Warnings blockieren die Bereitschaft nie. **Nur Batteriepässe** in dieser Version — ein Nicht-Batterie-Pass liefert `ready: true` mit einer einzelnen `REG-READY-SCOPE`-Warning, da die formale Registry-Prüfung für andere Kategorien noch nicht modelliert ist. Nur lesend; zählt als ein v1-Passlesezugriff gegen das Tageslimit.

Pfad-Parameter

  • iderforderlich

    ObjectId

    Pass-ID.

Header

  • Authorizationerforderlich

    string

    `Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

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

Antwort

{
  "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."
    }
  ]
}

Verwandte Endpoints