Herkese açık pasaport okumaları

Yöntemler

• GET/v1/dpps/{dppId}

  Bir pasaportu kimliğine göre okuyun.

• GET/v1/dppsByProductId/{productId}

  Bir ürünün pasaportunu okuyun.

• POST/v1/dppsByProductIds

  Birkaç ürünün pasaport kimliklerini bulun.

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"
}

Tanımlayıcılar

dppId, pasaportun digitalProductPassportId değeridir ve yüzde kodlamalıdır. Pasaportun yalnızca kimliği de çalışır.

productId, pasaportun uniqueProductIdentifier değeridir ve yüzde kodlamalıdır. Bu, pasaportun GS1 Digital Link bağlantısıdır; ürünün barkodu yoksa pasaport adresidir.

İstek gövdesinde JSON dizisi olarak en fazla 500 ürün tanımlayıcısı gönderin. Her tanımlayıcıyı pasaportun verdiği haliyle aynen gönderin. İki GET yönteminin gerektirdiği yüzde kodlamasını eklemeyin. Yanıt, bulunan pasaport kimliklerini gönderdiğiniz sırayla listeler. Yayımlanmış hiçbir pasaportla eşleşmeyen ürün tanımlayıcısı yanıttan çıkarılır.

limit, bir sayfanın kaç ürün tanımlayıcısı okuyacağını belirler; değer 1 ile 100 arasındadır. limit verilmezse bir sayfa 50 tanımlayıcı okur. Okunacak başka tanımlayıcı kaldığı sürece paging_metadata.cursor, sonraki sayfa için cursor olarak göndermeniz gereken değeri içerir.

Temsil biçimi

Pasaport varsayılan olarak sıkıştırılmış biçimde gelir. Her öğenin türünü belirten tam biçim için ?representation=full ekleyin.

Tarayıcılar

Bir tarayıcının isteği gibi HTML tercih eden bir istek, pasaport sayfasına yönlendirilir.

Durum kodları

501 dışındaki her hata bir result nesnesi taşır. Bu nesne, her biri messageType, text, code ve timestamp içeren bir ileti listesi barındırır. Programlar code değerini okumalıdır; bu değer hiç değişmez.