GETHent en ordre
Henter ordrens indhold og køstatus. Ændrer ingen data og registrerer ikke forbrug.
Endpoint
GET
https://www.tcgm.dk/api/v1/webshop/orders/{orderid}Autorisation
Bearer-nøgle medwebshop:orders:read
Path-parametre
orderidstring · påkrævet- TCGM-ordrens id fra oprettelsessvaret eller et ordreopslag (wshop_o_…). Brug ikke externalId, providerOrderId eller orderNumber.
Query-parametre
organizationstring · påkrævet- Organisationens ID fra /api/v1/access. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.
webshopstring · påkrævet- Netbutikkens ID fra /api/v1/access. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.
Headers
Authorizationstring · påkrævet- Bearer <api-nøgle>. Nøglen oprettes af en owner/admin på organisationens API-side.
Gemmes kun i denne sides hukommelse.
Response · 200
Den aktuelle ordre.
Response · 200
Cache-Control: no-store
{
order: {
id: string;
externalId: string;
providerOrderId: string;
orderNumber: string | null;
displayName: string;
creatorTag: string | null;
syncedBy: string | null;
createdAt: string;
receivedAt: string;
updatedAt: string;
completedAt: string | null;
queue: {
hidden: boolean;
position: number | null;
preparing: boolean;
};
lines: Array<{
id: string;
externalId: string;
productId: string;
variantId: string | null;
itemName: string;
quantity: number;
}>;
};
}Statuskoder
- 200
- Den aktuelle ordre.
- 400
- Ugyldigt input: invalid_request.
- 401
- Manglende eller ugyldig Bearer-nøgle: invalid_credential.
- 403
- Adgang nægtet: nøgle, scope, ejerskab eller godkendelse er ikke længere gyldig.
- 404
- Ressourcen findes ikke eller er ikke tilgængelig.
- 503
- Lager eller behandling er utilgængelig. Ingen interne fejl eller skemadetaljer udleveres i produktion.
- 405
- HTTP-metoden understøttes ikke.
Headers og fejlfelter
Response · 400, 403, 404, 503
Cache-Control: no-store
{
error: string;
}Response · 401
Cache-Control: no-store
WWW-Authenticate: Bearer
{
error: string;
}Adfærd og genforsøg
queue.position er null for skjulte eller afsluttede ordrer. queue.preparing beskriver fortsat forberedelse.