Lecturas públicas de pasaportes

Métodos

• GET/v1/dpps/{dppId}

  Leer un pasaporte por su identificador.

• GET/v1/dppsByProductId/{productId}

  Leer el pasaporte de un producto.

• POST/v1/dppsByProductIds

  Buscar los identificadores de pasaporte de varios productos.

curl "https://passportcraft.com/v1/dpps/https%3A%2F%2Fpassportcraft.com%2Fpassport%2F{id}"

{
  "digitalProductPassportId": "https://passportcraft.com/passport/{id}",
  "uniqueProductIdentifier": "https://passportcraft.com/01/{gtin}",
  "granularity": "model",
  "dppSchemaVersion": "EN18223:v1.0",
  "dppStatus": "active",
  "lastUpdated": "2026-01-01T00:00:00Z"
}

Identificadores

dppId es el digitalProductPassportId del pasaporte, con codificación porcentual. El identificador del pasaporte por sí solo también sirve.

productId es el uniqueProductIdentifier del pasaporte, con codificación porcentual. Es su GS1 Digital Link o, si el producto no tiene código de barras, la dirección de su pasaporte.

Envíe hasta 500 identificadores de producto como array JSON en el cuerpo de la solicitud. Envíe cada identificador exactamente como lo da el pasaporte. No añada la codificación porcentual que necesitan los dos métodos GET. La respuesta lista los identificadores de pasaporte encontrados, en el orden en que los envió. Un identificador de producto que no coincide con ningún pasaporte publicado se omite.

limit fija cuántos identificadores de producto lee una página, de 1 a 100. Sin limit, una página lee 50. Mientras queden más, paging_metadata.cursor contiene el valor que debe enviar como cursor para la página siguiente.

Representación

El pasaporte llega por defecto en forma comprimida. Añada ?representation=full para obtener la forma completa, que indica el tipo de cada elemento.

Navegadores

Una solicitud que prefiere HTML, como la de un navegador, se redirige a la página del pasaporte.

Códigos de estado

Todo error salvo 501 incluye un objeto result. Contiene una lista de mensajes, cada uno con messageType, text, code y timestamp. Los programas deben leer code, que nunca cambia.