Test-ShopifyAccess

ÜBERSICHT

Prüft ob ein Shopify API-Token die benötigten Berechtigungen (Scopes) hat.

SYNTAX

Test-ShopifyAccess [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-RequiredScopes]
    <string[]> [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG

Ruft den Shopify-Endpunkt /admin/oauth/access_scopes.json ab und vergleicht die gewährten Scopes mit den angeforderten. Gibt ein Ergebnisobjekt zurück, das anzeigt ob alle benötigten Scopes vorhanden sind und welche ggf. fehlen.

Typischer Einsatz als Preflight-Check vor dem eigentlichen Workflow, um kryptische 403-Fehler auf einzelnen Endpoints frühzeitig zu erkennen.

PARAMETER

-Shop

Type: string

Shopify-Shop-Domain, z.B. 'mein-shop.myshopify.com'.

-Token

Type: string

Admin API Access Token (shpat_...) der Custom App.

-ApiVersion

Type: string

API-Version, z.B. '2025-01'.

-RequiredScopes

Type: string[]

Array der benötigten Scopes, z.B. @('read_products', 'write_orders').

-TimeoutSec

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN

pscustomobject -- Objekt mit Valid, GrantedScopes, RequiredScopes, MissingScopes.

BEISPIELE

# Preflight-Check für Bestellimport
$check = Test-ShopifyAccess -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -RequiredScopes @('read_orders', 'write_orders')
if (-not $check.Valid) {
  throw "Fehlende Scopes: $($check.MissingScopes -join ', ')"
}

# Alle Scopes abfragen ohne Pflichtprüfung
$check = Test-ShopifyAccess -Shop $shop -Token $token `
  -ApiVersion '2025-01' -RequiredScopes @()
$check.GrantedScopes  # Zeigt alle gewährten Scopes