Terug naar de changelog

Digital IDs aanvragen via de API

Genereer Digital IDs voor een Purchase Order en print de QR-codes zelf, in je eigen tempo — inclusief het vervangen van een batch die een fabriek halverwege een run verkeerd heeft geprint.

Er zijn drie endpoints beschikbaar, geauthenticeerd met een API-key. Een POST naar het purchase-order tags-endpoint geeft Digital IDs terug met de URL die in elke QR-code moet worden gecodeerd. Zonder aantallen genereert het de volledige productierun uit de order lines; met aantallen genereert het precies dat aantal, wat de manier is om misprints te vervangen.

Een read-request op hetzelfde pad geeft de IDs terug die al voor een lot zijn uitgegeven, zodat een verloren response te herstellen is zonder een tweede run aan te maken. Een apart endpoint accepteert IDs die je zelf hebt gegenereerd, gegroepeerd per lot. URLs komen terug als GS1 Digital Links of als ?pid=-links, en wijzen altijd naar je consumer-domein in plaats van naar de API-host.

Limits zijn 20.000 IDs per request en 30 requests per minuut per key. Keys dragen generate- of write-permissie, worden per account en per omgeving uitgegeven, en de volledige credential wordt één keer getoond — een verloren key wordt vervangen, niet hersteld.

Er moet een Purchase Order voor het lot bestaan voordat IDs ertegen kunnen worden gegenereerd, en Digital IDs die een shopper al heeft geclaimd behouden hun product. De admin-generatiebatch en -bestandsexport blijven beschikbaar.

Was deze pagina nuttig?