Udvikler-API og MCP
Du kan læse dine e-mail-layouts, e-mail-afsendere, hemmeligheder, uploadede filer og HTTP-anmodninger fra din egen kode eller fra en AI-assistent og administrere dine HTTP-anmodninger og mediefiler. Workflow Transactional Email stiller en REST-API og en MCP-server til rådighed, som begge administreres på siden »Developer« inde i appen.
Alt bruger ét sæt legitimationsoplysninger, og begge platforme håndhæver de samme regler: Dine hemmeligheder kan aldrig læses, og historikken maskeres, før den returneres.
Den korte version
Basis-URL
https://shopify.workflow-transactional-email.appLog ind med en »bearer key«, der er oprettet på udviklersiden. Nøglerne begynder med fak_ og vises én gang, når de oprettes.
Tre adgangsniveauer, i rækkefølge og kumulativt:
| Niveau | Tilføjer |
|---|---|
| Læs | Læs e-mail-layouts, afsendere, hemmelige navne, uploadede filer, HTTP-anmodninger, historik og statistik |
| Læs og skriv | Opret, rediger og slet HTTP-anmodninger; slet ubrugte uploadede filer |
| Læs, skriv og udfør | Udfør en HTTP-anmodning mod det egentlige mål |
Udsted læsenøgler som standard.
Organisering af dine medier
En almindelig anvendelse: Find alle uploadede logoer eller billeder, som ingen længere henviser til, og slet dem.
# every file, each flagged with whether a layout or preset still uses it
curl "https://shopify.workflow-transactional-email.app/api/v1/files?usage=true" \
-H "Authorization: Bearer fak_your_key_here"
# delete one that nothing references
curl -X DELETE "https://shopify.workflow-transactional-email.app/api/v1/files" \
-H "Authorization: Bearer fak_your_key_here" \
-H "Content-Type: application/json" \
-d '{"key":"uploads/your-shop.myshopify.com/abc123.png"}'En fil, der stadig bruges af et layout eller en forudindstilling til sidehoved/sidefod, afvises med en 409-fejl, hvor det angives, hvad der bruger den, så et oprydningsscript ikke ved et uheld kan ødelægge en aktiv e-mail.
En første anmodning
Bekræft, at en nøgle virker, og se, hvad den kan:
curl https://shopify.workflow-transactional-email.app/api/v1/me \
-H "Authorization: Bearer fak_your_key_here"Yderligere læsning
- Hemmeligheder - hvordan hemmeligheder fungerer i selve appen.
- Send en HTTP-anmodning fra Shopify Flow - den HTTP-handling, som disse endpunkter konfigurerer.
- Vedhæftede filer og billeder - at uploade og genbruge filer i appen.
- Historik og fejlfinding - hvad der registreres i udførelseshistorikken.

