Produkte und Dateien

Products

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

GET / v1 / products

The products of the account, newest first: name, type, status, price, billing, number of sales, shop link and admin link.

price is the normal price. current_price is what buyers pay now: a running limited offer replaces the price.
sales counts paid orders and orders in payment of all time, refunded and free orders included. paid_sales counts only orders with an amount above 0.
Without status, the list has live and draft products. Archived products are deleted products.
Prices are in the account currency.

For texts, images, files, variants and the linked course, call GET /v1/products/{product_id}.

Liest nur MCP-Werkzeug list_products

curl "https://api.tentary.com/v1/products?status=live&limit=2" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/products?status=live&limit=2", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/products",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    params={
        "status": "live",
        "limit": 2,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/products?status=live&limit=2');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "currency": "EUR",
  "products": [
    {
      "id": 103,
      "name": "Yoga Club",
      "type": "link",
      "status": "live",
      "price": "19.00",
      "current_price": "19.00",
      "price_is_from": false,
      "billing": "subscription",
      "billing_interval_months": 1,
      "hide_in_shop": false,
      "sales": 1,
      "paid_sales": 1,
      "url": "https://lena-yoga.mytentary.com/p/yoga-club",
      "checkout_url": "https://lena-yoga.mytentary.com/p/yoga-club/checkout",
      "admin_url": "https://app.tentary.com/products/edit/103"
    },
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days",
      "type": "course",
      "status": "live",
      "price": "49.00",
      "current_price": "39.00",
      "price_is_from": false,
      "billing": "one_time",
      "billing_interval_months": null,
      "hide_in_shop": false,
      "sales": 1,
      "paid_sales": 1,
      "url": "https://lena-yoga.mytentary.com/p/morning-yoga",
      "checkout_url": "https://lena-yoga.mytentary.com/p/morning-yoga/checkout",
      "admin_url": "https://app.tentary.com/products/edit/102"
    }
  ],
  "next_cursor": "aWQ6MTAy",
  "links": {
    "products": "https://app.tentary.com/products"
  }
}

Autorisierung

Authorization string Header erforderlich

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Einführung

Query-Parameter

type string

Only products of this type.

Mögliche Werte: downloadlinknewsletterbookingcoursebundleexternal
status string

Only products with this status.

Mögliche Werte: livedraftarchived

Beispiel: "live"
query string

Part of the product name.

max. Länge 100
cursor string

next_cursor of the previous page. Send the same filters and limit again: the cursor does not keep them. Leave out for the first page.
limit integer

Items per page, default 25.

min. 1 max. 50 Beispiel: 2

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

currency string

Currency code, like EUR. Prices are in this currency.
products array of object

Newest first.
15 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string
  
  Product name.
- type string
  
  The type.
  
  Mögliche Werte: downloadlinknewsletterbookingcoursebundleexternal
- status string
  
  archived = deleted.
  
  Mögliche Werte: livedraftarchived
- price string
  
  Decimal string, like "19.90". Normal price.
- current_price string
  
  Decimal string, like "19.90". What buyers pay now: a running limited offer replaces the price.
- price_is_from boolean
  
  true = the product has variants and price is the lowest variant price.
- billing string
  
  How the buyer pays: one_time, subscription or installments.
  
  Mögliche Werte: one_timesubscription
- billing_interval_months integer kann null sein
  
  Subscription: months between payments.
- hide_in_shop boolean
  
  true = not shown on the shop page.
- sales integer
  
  Paid orders and orders in payment of all time, refunded and free orders included.
- paid_sales integer
  
  Orders with an amount above 0.
- url string<uri>
  
  Sales page.
- checkout_url string<uri> kann null sein
  
  Checkout page. Only for live products.
- admin_url string<uri>
  
  The product in the Tentary app.
next_cursor string kann null sein

Send it as cursor for the next page, with the same filters and limit. null = this is the last page.
links object

Pages in the Tentary app or on tentary.com.
1 Feld anzeigen Felder ausblenden
- products string<uri>
  
  Page in the Tentary app.