TracePass
Започнете
EPCIS 2.0

Заявяване на EPCIS събития

Търсете заснетите от вас събития във веригата на доставки чрез параметрите за заявка на EPCIS 2.0. Поддържат се осем: EQ_bizStep, EQ_disposition, EQ_eventType, MATCH_epc, EQ_bizLocation, EQ_readPoint, GE_eventTime и LT_eventTime. EQ_bizStep, EQ_disposition и MATCH_epc приемат стойности, разделени с |, за да съвпаднат с една от няколко (EQ_bizStep=shipping|receiving); останалите параметри приемат една стойност. Съвпадението е точно спрямо стойността във вида, в който е заснета, така че събитие, заснето с краткия вид shipping, не се намира чрез CBV URI вида, и обратно. Всеки друг параметър връща 400, вместо да бъде игнориран мълчаливо — така една печатна грешка се проваля видимо, а не разширява резултата ви.

GET/api/v1/epcis/events
Изтегли OpenAPI 3.1
GET/api/v1/epcis/events

Заявяване на EPCIS събития

Търсете заснетите от вас събития във веригата на доставки чрез параметрите за заявка на EPCIS 2.0. Поддържат се осем: EQ_bizStep, EQ_disposition, EQ_eventType, MATCH_epc, EQ_bizLocation, EQ_readPoint, GE_eventTime и LT_eventTime. EQ_bizStep, EQ_disposition и MATCH_epc приемат стойности, разделени с |, за да съвпаднат с една от няколко (EQ_bizStep=shipping|receiving); останалите параметри приемат една стойност. Съвпадението е точно спрямо стойността във вида, в който е заснета, така че събитие, заснето с краткия вид shipping, не се намира чрез CBV URI вида, и обратно. Всеки друг параметър връща 400, вместо да бъде игнориран мълчаливо — така една печатна грешка се проваля видимо, а не разширява резултата ви.

Резултатите се връщат като валиден според стандарта EPCISQueryDocument (Content-Type: application/ld+json), най-новите първи, и включват само събития, заснети и одобрени във вашето работно пространство. Отговорът е ограничен до 1000 събития; ако е имало повече, се задава X-TracePass-Result-Truncated: true — стеснете периода с GE_eventTime / LT_eventTime, за да преминете през страниците. Брои се като едно четене.

Гейт на плана: EPCIS заявките са включени във всеки план, включително Free. Пътят 403 epcis_query_not_available е достъпен само при работни пространства, в които EPCIS е изключен от поддръжката. Заявката е четене, затова продължава да работи и когато плащането е просрочено, неплатено или абонаментът е анулиран. EPCIS заявките се активират при поискване; докато не са активирани, endpoint-ът връща 503 {"error":"epcis_query_node_unavailable"} — свържете се с поддръжката, за да бъдат активирани.

Query параметри

  • EQ_bizStep

    string

    Стандартен EPCIS query параметър — съответства на събития, чийто bizStep е равен на дадената CBV стойност (напр. shipping, receiving); разделете няколко стойности с |, за да съответства на която и да е от тях. TracePass анализира параметъра и го прилага към собственото хранилище на събития на вашето работно пространство — празна стойност или неподдържан параметър връща 400.

  • GE_eventTime

    string (ISO 8601)

    Стандартен EPCIS query параметър — съответства на събития, чийто eventTime е по-голям или равен на дадения времеви маркер. Комбинирайте с LT_eventTime за прозорец. Стойност, която не може да се разчете като дата, връща 400.

  • MATCH_epc

    string

    Стандартен EPCIS query параметър — съответства на събития, чийто epcList съдържа дадения EPC (Digital Link URI на паспорт в TracePass); разделете няколко EPC с |, за да съответства на който и да е от тях.

Хедъри

  • Authorizationзадължително

    string

    Bearer <token> — или tp_ API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Заявка

# All shipping events for one passport in a time window
curl -sS -G https://app.tracepass.eu/api/v1/epcis/events \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  --data-urlencode "EQ_bizStep=shipping" \
  --data-urlencode "GE_eventTime=2026-01-01T00:00:00.000Z" \
  --data-urlencode "LT_eventTime=2026-06-01T00:00:00.000Z" \
  --data-urlencode "MATCH_epc=https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"

Отговор

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
  "type": "EPCISQueryDocument",
  "schemaVersion": "2.0",
  "creationDate": "2026-05-09T12:00:00.000Z",
  "epcisBody": {
    "queryResults": {
      "resultsBody": {
        "eventList": [
          {
            "type": "ObjectEvent",
            "eventID": "ni:///sha-256;9f86d0...?ver=CBV2.0",
            "eventTime": "2026-05-09T11:58:00.000Z",
            "eventTimeZoneOffset": "+02:00",
            "epcList": ["https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"],
            "action": "OBSERVE",
            "bizStep": "shipping"
          }
        ]
      }
    }
  }
}

Свързани endpoints