request_mandate – Ausgabe-Mandat anfordern

Bittet den Menschen um ein Budget (Gesamt, pro Bestellung, Kategorien, Laufzeit). Liefert approval_url für den Menschen. Nach Freigabe: checkout mit mandate_id ohne weitere Rückfrage.

HTTP

POST /api/mandates

Zugang

Konto (API-Key) nötig

Bereich

Konto

Nur lesend

nein

Du bist nicht angemeldet. Anmelden

Formular

Eingabeschema (JSON Schema)

{
    "type": "object",
    "properties": {
        "description": {
            "type": "string",
            "description": "Wofür? z. B. \"Büromaterial Q4\""
        },
        "max_total": {
            "type": "number",
            "description": "Gesamtbudget EUR"
        },
        "max_per_order": {
            "type": "number",
            "description": "Max. pro Bestellung EUR"
        },
        "categories": {
            "type": "array",
            "items": {
                "type": "string",
                "enum": [
                    "Smartphones & Tablets",
                    "Notebooks & PCs",
                    "PC-Komponenten",
                    "Gaming",
                    "Audio & Kopfhörer",
                    "TV & Heimkino",
                    "Smart Home",
                    "Wearables",
                    "Kameras & Drohnen",
                    "Zubehör & Gadgets"
                ]
            },
            "description": "Erlaubte Kategorien (leer = alle)"
        },
        "expires_in_days": {
            "type": "integer",
            "minimum": 1,
            "maximum": 365
        }
    },
    "required": [
        "max_total"
    ]
}

REST

curl -X POST https://anltx.com/api/mandates \
  -H "Authorization: Bearer $ANLTX_KEY" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"max_total":"<max_total>"}'

MCP

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "request_mandate",
        "arguments": {
            "max_total": "<max_total>"
        }
    }
}

Alle Werkzeuge