Pakkausvelvoitteiden seuranta · KEHITTÄJÄKÄYTTÖ

API ja webhookit

Käytä alla olevissa esimerkeissä tuotteesi osoitetta. Säilytä API-avaimet palvelimellasi. Avaa interaktiivinen API-dokumentaatio ↗

Lue julkisia tietueita

curl 'https://verpackung.getregisters.com/api/v1/feeds/de-packaging-compliance/records?limit=50&offset=0'

Julkiset vastaukset sisältävät vain kolme uusinta tietuetta rekisteriä kohden. Vanhempien tietueiden sisältö edellyttää PRO-käyttöoikeutta; suorat osoitteet näyttävät rajatun esikatselun. Seuraa next_offset-arvoa, kunnes se on null, myös silloin kun suodatettu sivu on tyhjä. Viittaa jokaiseen alkuperäiseen source_url-lähteeseen. Julkaisu- ja havaintopäivämäärät kuvaavat eri tapahtumia.

Lue PRO-tietueita

curl 'https://verpackung.getregisters.com/api/v1/feeds/de-packaging-compliance/records?limit=50&offset=0' \
  -H 'Authorization: Bearer YOUR_SCOPED_KEY'

Luo tai vaihda avain tililläsi. Avain toimii vain tässä tuotteessa ja niin kauan kuin maksullinen käyttöoikeus on aktiivinen.

Vientimuodot

PRO sisältää CSV-, Excel- (.xlsx), XML-, RSS- ja Atom-muodot. Käytä tuotteesi API-avainta ja samoja suodattimia kaikissa muodoissa. Voit esimerkiksi ladata enintään 100 tietuetta Excel-työkirjana:

curl 'https://verpackung.getregisters.com/api/v1/feeds/de-packaging-compliance/records/export.xlsx?limit=100&offset=0' \
  -H 'Authorization: Bearer YOUR_SCOPED_KEY' \
  -D export-headers.txt -o records.xlsx

Korvaa xlsx arvolla csv, xml, rss tai atom. Lisää esimerkiksi suodattimet document_type=adopted tai facility_id=YOUR_FACILITY_ID. Seuraa vastauksen Link-otsaketta, jonka rel="next", kunnes sitä ei enää ole; säilytä Authorization-otsake jokaisessa pyynnössä. Sivulla on enintään 100 tietuetta; suodatettu sivu voi olla tyhjä, vaikka seuraavia sivuja vielä olisi.

Määritä RSS- ja Atom-syötteille lukija, joka tukee Authorization-otsaketta. Lukijan osoitteissa ei ole avainta. Merkinnöillä on pysyvät tietuetunnukset, ja lukijat, jotka eivät seuraa sivutusta, saavat uusimman sivun. Käytä sivutettua API:a, kun tarvitset kaikki tietueet.

Lue tietueen historia

curl 'https://verpackung.getregisters.com/api/v1/records/RECORD_ID/history?limit=50&offset=0' \
  -H 'Authorization: Bearer YOUR_SCOPED_KEY'

Korvaa RECORD_ID palautetulla tietuetunnuksella. Historia palauttaa taulukon uusimmasta vanhimpaan. Jatka kasvattamalla offset-arvoa sivun pituudella, kunnes sivu on pyydettyä limit-arvoa lyhyempi. Versiot voivat kuvata lähteen muutoksia tai poiminnan korjauksia.

Yhdistä MCP:n avulla

curl 'https://verpackung.getregisters.com/api/v1/mcp' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"read_register","arguments":{"feed_id":"de-packaging-compliance"}}}'

Lisää sama Authorization-otsake PRO-kenttiä varten. Päätepiste tukee myös toimintoja initialize, tools/list ja notifications/initialized. Käytä yllä kuvattua REST-sivutusta, kun luet koko rekisterin.

Vahvista webhookien allekirjoitukset

Allekirjoitusotsake on X-Register-Signature: t=TIMESTAMP,v1=HEX_DIGEST. Vahvista käsittelemätön viestirunko ennen JSON:n jäsentämistä. Säilytä pysyvä kirjaus onnistuneesti käsitellyistä X-Register-Event-tunnuksista, jotta uudelleenyritykset eivät toista sivuvaikutuksia.

import { createHmac, timingSafeEqual } from 'node:crypto';

export function verify(rawBody, header, secret) {
  const fields = Object.fromEntries(header.split(',').map(x => x.split('=')));
  const timestamp = Number(fields.t);
  if (!Number.isFinite(timestamp) || Math.abs(Date.now()/1000 - timestamp) > 300) return false;
  if (!/^[a-f0-9]{64}$/.test(fields.v1 || '')) return false;
  const expected = createHmac('sha256', secret).update(fields.t + '.').update(rawBody).digest();
  const supplied = Buffer.from(fields.v1, 'hex');
  return supplied.length === expected.length && timingSafeEqual(supplied, expected);
}

Palauta onnistunut vastaus vasta, kun tapahtuma on kirjattu pysyvästi. Toimitusta yritetään uudelleen rajallisen määrän kertoja; viimeisin kirjattu tulos näkyy tililläsi. Toimituksen kuittaus ei vahvista, että sovelluksesi on saanut tapahtuman käsittelyn valmiiksi.