Rechtstexte

Update legal texts

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

PATCH / v1 / legal

Saves legal texts of the shop as HTML. Allowed tags: h2 to h5, p, ul, li, strong, a, br and hr.

Only the texts that you send change. An empty text removes the document.
Buyers see the change at once.

Start from GET /v1/legal/templates/{document} and fill in the real data of the account. Never invent it. GET /v1/legal shows which documents the country of the account needs.

Ändert sofort MCP-Werkzeug update_legal_texts

curl -X PATCH "https://api.tentary.com/v1/legal" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "attach_terms_to_order_emails": true
}'

const response = await fetch("https://api.tentary.com/v1/legal", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "attach_terms_to_order_emails": true
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/legal",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "attach_terms_to_order_emails": True,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/legal');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'attach_terms_to_order_emails' => true,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "country": "DE",
  "documents": [
    {
      "document": "terms",
      "title": "Terms of service",
      "filled": true,
      "html": "<h2>Terms of service</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "cancellation",
      "title": "Cancellation policy",
      "filled": true,
      "html": "<h2>Cancellation policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "privacy",
      "title": "Privacy policy",
      "filled": true,
      "html": "<h2>Privacy policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "imprint",
      "title": "Legal notice (Impressum)",
      "filled": true,
      "html": "<h2>Impressum</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    }
  ],
  "attach_terms_to_order_emails": true,
  "admin_url": "https://app.tentary.com/settings/legal",
  "shop_url": "https://shop.tentary.com/legal/61326/tos"
}

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

Body application/json

terms_html string

Terms of service.

max. Länge 200000
cancellation_html string

EU: cancellation policy. Other countries: return and refund policy.

max. Länge 200000
privacy_html string

Privacy policy.

max. Länge 200000
imprint_html string

Germany, Austria, Switzerland: Impressum. Other countries: contact information.

max. Länge 200000
attach_terms_to_order_emails boolean

Attach the terms and the cancellation policy as a PDF to every order e-mail.

Antwort

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

country string

Seller country, like DE. It decides which documents the shop needs.
documents array of object

The legal documents for the seller country.
4 Felder anzeigen Felder ausblenden
- document string
  
  terms, cancellation, privacy or imprint.
  
  Mögliche Werte: termscancellationprivacyimprint
- title string
  
  Name of the document for the seller country.
- filled boolean
  
  true = the text is not empty.
- html string
  
  The text as HTML.
attach_terms_to_order_emails boolean

true = the terms and the cancellation policy go as a PDF with every order e-mail.
admin_url string<uri>

The page in the Tentary app.
shop_url string<uri>

The terms in the shop.