B2BB2B LLM

Partner API Endpunkte

Vervollständigen Sie Partner API Anfrage- und Antwortbeispiele für Schlüssel, Gruppen, Anfragen und Transaktionen.

Partner API Endpunkte

Basis-URL:

https://p-api.model-gate.com

Alle Anfragen erfordern:

Authorization: Bearer mg_partner_...
Accept: application/json

Alle Geld- und Grenzwertwerte sind JSON-Dezimalzeichenfolgen. Analysieren Sie sie nicht als binäre Gleitkommazahlen.

Gemeinsame Regeln zur Bankenintegration

Alle externen Zeitstempel sind UTC RFC3339. Verwendung von Sammlungsendpunkten limit (1–100) plus ein undurchsichtiges cursor; Analysieren oder erstellen Sie niemals Cursorinhalte. POST, PATCH, Und DELETE Anfragen erfordern Idempotency-Key; Versuchen Sie nach Zeitüberschreitungen denselben Vorgang mit demselben Schlüssel erneut. Idempotenzaufzeichnungen werden 7 Tage lang aufbewahrt. Zu den Antworten gehören: X-Request-ID, Sind Cache-Control: no-store, und alle Fehler sind JSON. Antworten mit Ratenbegrenzung erfolgen über HTTP 429 mit Retry-After Und X-RateLimit-* Kopfzeilen. Unbekannte Text-/Abfragefelder werden abgelehnt.

Der maschinenlesbare OpenAPI 3.1-Vertrag wird verteilt als resources/contracts/partner-api.openapi.yaml.

Erstellen Sie einen API-Schlüssel

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/keys \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Telegram user 123",
    "group_id": "GROUP_PUBLIC_ID",
    "rpm_limit": 30,
    "concurrency_limit": 2,
    "spend_limit": "20.0000000000",
    "usage_price_basis": "official_price",
    "usage_price_multiplier": "0.900000"
  }'

Antwort – 201

{
  "data": {
    "public_id": "KEY_PUBLIC_ID",
    "group_id": "GROUP_PUBLIC_ID",
    "name": "Telegram user 123",
    "key_prefix": "mg_live_ab12",
    "key": "mg_live_ab12...",
    "status": "active",
    "rpm_limit": 30,
    "concurrency_limit": 2,
    "spend_limit": "20.0000000000",
    "usage": "0.0000000000",
    "total_spent": "0.0000000000",
    "usage_price_basis": "official_price",
    "usage_price_multiplier": "0.900000",
    "effective_usage_price_basis": "official_price",
    "effective_usage_price_multiplier": "0.900000"
  }
}

Das Komplette key Der Wert wird erst nach der Erstellung oder Rotation zurückgegeben.

API-Schlüssel auflisten

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/keys \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": [
    {
      "public_id": "KEY_PUBLIC_ID",
      "group_id": "GROUP_PUBLIC_ID",
      "name": "Telegram user 123",
      "status": "active",
      "spend_limit": "20.0000000000",
      "usage": "3.2500000000",
      "total_spent": "1.1400000000"
    }
  ]
}

Die Liste wird nach dem Neuesten zuerst sortiert und verwendet eine undurchsichtige Cursor-Paginierung. Passieren limit=1..100; Wann meta.has_more ist wahr, senden meta.next_cursor als nächstes cursor.

Holen Sie sich einen API-Schlüssel

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": {
    "public_id": "KEY_PUBLIC_ID",
    "group_id": "GROUP_PUBLIC_ID",
    "name": "Telegram user 123",
    "status": "active",
    "rpm_limit": 30,
    "concurrency_limit": 2,
    "spend_limit": "20.0000000000",
    "usage": "3.2500000000",
    "total_spent": "1.1400000000",
    "effective_usage_price_basis": "official_price",
    "effective_usage_price_multiplier": "0.900000"
  }
}

Aktualisieren Sie einen API-Schlüssel

PATCH ersetzt nur die unterstützten veränderlichen Werte. Um den Schlüssel aus einer Gruppe zu entfernen, senden Sie eine leere Nachricht group_id. Um Bewertungseinstellungen zu erben, senden Sie null für die Basis und den Multiplikator auf Schlüsselebene.

Anfrage

curl -X PATCH https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated user name",
    "group_id": "GROUP_PUBLIC_ID",
    "rpm_limit": 60,
    "concurrency_limit": 4,
    "spend_limit": "40.0000000000",
    "usage_price_basis": null,
    "usage_price_multiplier": null
  }'

Antwort – 200

{
  "data": {
    "public_id": "KEY_PUBLIC_ID",
    "spend_limit": "40.0000000000",
    "usage": "3.2500000000",
    "effective_usage_price_basis": "user_price",
    "effective_usage_price_multiplier": "1.000000"
  }
}

Löschen Sie einen API-Schlüssel

Anfrage

curl -X DELETE https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort – 200

{"data":{"deleted":true}}

Einen Schlüssel einfrieren und wieder freigeben

Anfrage einfrieren

curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/freeze \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort einfrieren

{"data":{"public_id":"KEY_PUBLIC_ID","status":"frozen"}}

Anfrage freigeben

curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/unfreeze \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort aufheben

{"data":{"public_id":"KEY_PUBLIC_ID","status":"active"}}

Zum Aufheben der Sperrung ist eine bestätigte E-Mail-Adresse des Eigentümers erforderlich.

Drehen Sie einen Schlüssel

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/rotate \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort – 200

{
  "data": {
    "public_id": "KEY_PUBLIC_ID",
    "status": "active",
    "key_prefix": "mg_live_cd34",
    "key": "mg_live_cd34..."
  }
}

Schlüsselverwendung zurücksetzen

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/reset-usage \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort – 200

{
  "data": {
    "public_id": "KEY_PUBLIC_ID",
    "usage": "0.0000000000",
    "total_spent": "1.1400000000"
  }
}

Durch das Zurücksetzen der Nutzung ändern sich weder die Lebenszeitausgaben noch der Kontostand.

Erhalten Sie die Schlüsselnutzung

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/usage \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": {
    "key_id": "KEY_PUBLIC_ID",
    "usage": "3.2500000000",
    "total_spent": "1.1400000000"
  }
}

Erhalten Sie das Ausgabenlimit und die verbleibende Nutzung

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/spent-limit \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": {
    "key_id": "KEY_PUBLIC_ID",
    "spend_limit": "20.0000000000",
    "usage": "3.2500000000",
    "remaining": "16.7500000000"
  }
}

Wann spend_limit ist Null, es ist unbegrenzt und remaining Ist null.

Erhalten Sie die neuesten Anfragen für einen Schlüssel

Der detaillierte Anforderungsverlauf ist ein Hot-Retention-Datensatz, der von gesteuert wird API_REQUESTS_HOT_RETENTION_DAYS (Standard 7 Tage). Die Antwortmetadaten melden das aktive Aufbewahrungsfenster. Nutzen Sie Saldentransaktionen für einen längerfristigen Finanzabgleich.

limit ist optional, der Standardwert ist 10 und muss eine Ganzzahl von 1 bis 100 sein. Abgeschlossene Anforderungen werden nach sortiert finished_at Neueste zuerst. Wann meta.has_more Ist true, passieren meta.next_cursor als undurchsichtig before Abfrageparameter zum Abrufen der nächstälteren Seite. Analysieren oder erstellen Sie Cursor nicht selbst.

Die Antwort enthält unveränderliche Benutzer- und offizielle Pro-Million-Token-Preise für Anfragen, die nach der Migration abgeschlossen wurden 059_request_pricing_audit_snapshot.sql. Es rechnet auch pricing_snapshot.usage_price aus der gespeicherten Basis, dem Multiplikator und den historischen Kursen, ohne einen weiteren Tarifsatz zu speichern. Dies macht die unabhängige Bewertung des Nutzungslimits nach einer Änderung der Katalogpreise überprüfbar. Historische Anfragen, die vor der Migration 059 erstellt wurden, kehren zurück pricing_snapshot.available: false anstatt die aktuellen Preise zu ersetzen. Anfragen, die über Claude/OpenAI-kompatible Batch-APIs ausgeführt werden, sind explizit mit gekennzeichnet request_mode: "batch" und geben Sie deren Protokoll, Batch-Job-ID, custom_idund der Snapshot des Model Gate-Chargenpreismultiplikators.

Latenz verwendet stabile Geschäfts-/Partnernamen: gateway_overhead_ms, upstream_first_token_ms, Und e2e_first_token_ms. Der E2E-Erst-Token-Wert wird vom Start der Model Gate-Anfrage bis zum ersten echten Inhaltstoken gemessen und schließt die clientseitige Netzwerk-/TLS-Zeit aus. Das Partner API macht nur das Explizite verfügbar e2e_first_token_ms Name; Die interne Speichersäule bleibt erhalten api_requests.first_token_ms.

Anfrage

curl "https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/requests?limit=10" \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": [
    {
      "request_id": "01KZ...",
      "key_id": "KEY_PUBLIC_ID",
      "group_id": "GROUP_PUBLIC_ID",
      "model": "claude-opus-4.7",
      "endpoint": "messages",
      "method": "POST",
      "status": "succeeded",
      "status_code": 200,
      "is_stream": false,
      "request_mode": "batch",
      "batch": {
        "protocol": "claude",
        "job_id": "msgbatch_01K...",
        "custom_id": "request-1",
        "price_multiplier": "0.5"
      },
      "tokens": {
        "input": 120,
        "output": 45,
        "cached": 0,
        "cache_write": 0,
        "reasoning": 0,
        "total": 165
      },
      "cost": "0.0000345",
      "usage_cost": "0.00345",
      "official_base_cost": "0.000345",
      "currency": "USD",
      "usage_pricing": {
        "basis": "official_price",
        "base_field": "official_base_cost",
        "base_amount": "0.000345",
        "multiplier": "10",
        "usage_cost": "0.00345",
        "formula": "round(base_amount * multiplier, 10)"
      },
      "pricing_snapshot": {
        "available": true,
        "unit": "per_1m_tokens",
        "user_price": {
          "input": "0.2",
          "output": "1",
          "cache_read": "0.02",
          "cache_write": "0.25",
          "reasoning": "1"
        },
        "official_price": {
          "input": "1",
          "output": "5",
          "cache_read": "0.1",
          "cache_write": "1.25",
          "reasoning": "5"
        },
        "usage_price": {
          "input": "10",
          "output": "50",
          "cache_read": "1",
          "cache_write": "12.5",
          "reasoning": "50"
        }
      },
      "duration_ms": 842,
      "gateway_overhead_ms": 34,
      "upstream_first_token_ms": 156,
      "e2e_first_token_ms": 190,
      "settlement_status": "settled",
      "started_at": "2026-08-05T10:00:00Z",
      "finished_at": "2026-08-05T10:00:00.842Z"
    }
  ],
  "meta": {
    "key_id": "KEY_PUBLIC_ID",
    "limit": 10,
    "returned": 1,
    "order": "finished_at_desc",
    "next_cursor": "eyJ0IjoiMjAyNi0wOC0wNSAxMDowMDowMCIsInAiOiIwMUt...",
    "has_more": true
  }
}

Um mit der nächstälteren Seite fortzufahren:

curl "https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/requests?limit=10&before=NEXT_CURSOR" \
  -H "Authorization: Bearer mg_partner_..."

Ein Invalider before Der Cursor gibt HTTP zurück 422. Der Cursor enthält nur die Endzeitposition und die öffentliche ID der externen Anforderung. Interne numerische Anforderungs-IDs werden niemals offengelegt.

Für synchrone und native asynchrone Anfragen: request_mode Ist sync oder async und die batch Objekt wird weggelassen. Der gespeicherte Token-Rate-Snapshot ermöglicht die Reproduktion der historischen Basisberechnung als sum(tokens × snapshotted_rate / 1,000,000). Bei der Abrechnung wird der ausgewählte Basisbetrag auf 10 Dezimalstellen gerundet und anschließend berechnet round(base_amount × multiplier, 10). Das gespeicherte cost, official_base_cost, Und usage_cost Felder bleiben maßgebend.

Rohe Anforderungs- und Antworttexte werden von diesem Endpunkt niemals zurückgegeben.

Saldotransaktionen auflisten

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/transactions \
  -H "Authorization: Bearer mg_partner_..."

Antwort – 200

{
  "data": [
    {
      "transaction_id": "TRANSACTION_PUBLIC_ID",
      "type": "debit",
      "source": "api_usage_minute",
      "billing_minute_num": 29769120,
      "amount": "-0.0232000000",
      "request_count": 100,
      "balance_before": null,
      "balance_after": null,
      "api_key_id": null,
      "created_at": "2026-08-05T10:00:00Z"
    }
  ]
}

Der abrechenbare Rückschluss wird als eine Wallet-Ledger-Zeile pro Abrechnungseigentümer und Endzeitminute dargestellt. transaction_id ist die dauerhafte Kennung des öffentlichen Hauptbuchs. request_count ist die Anzahl der in dieser Minutenabbuchung enthaltenen Anfragen; billing_minute_num Ist floor(unix(finished_at)/60). Rohes internes Hauptbuch id / source_id Werte werden nicht zurückgegeben. Aggregierte API-Nutzungszeilen werden absichtlich zurückgegeben null für balance_before, balance_after, Und api_key_id; Die genauen Schlüssel-/Gruppen-/Anfragedetails bleiben im Anfrageverlauf und im Panel-Minuten-Drilldown verfügbar.

Aktuellen Kontostand abrufen

curl https://p-api.model-gate.com/api/v1/partner/balance \
  -H "Authorization: Bearer mg_partner_..."
{"data":{"balance":"1234.5678900000","currency":"USD","as_of":"2026-08-28T07:00:00Z"}}

Verwenden Sie diesen Endpunkt danach account.balance_low Rückrufe zum Abgleichen der aktuellen Konto-Wallet, ohne dass eine Model-API-Anmeldeinformation erforderlich ist.

Partner-Audit-Ereignisse auflisten

curl "https://p-api.model-gate.com/api/v1/partner/audit-events?limit=100" \
  -H "Authorization: Bearer mg_partner_..."

Audit-Ereignisse zeichnen erfolgreiche Partnerverwaltungsmutationen mit Anforderungs-ID, Aktion, Ziel, Quell-IP, Status, sicheren Metadaten und UTC-Zeitstempel auf. Geheimnisse, Inhabertokens, API-Schlüssel-Klartext, Idempotenzschlüssel, Anforderungsfingerabdrücke und Wiedergabetexte werden nicht in Audit-Metadaten gespeichert. Verwenden cursor für Folgeseiten und optional action Filterung.

Erstellen Sie eine Gruppe

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/groups \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Telegram bot A",
    "description": "Keys created by bot A",
    "rpm_limit": 100,
    "concurrency_limit": 20,
    "spend_limit": "1000.0000000000",
    "usage_price_basis": "official_price",
    "usage_price_multiplier": "0.900000"
  }'

Antwort – 201

{
  "data": {
    "public_id": "GROUP_PUBLIC_ID",
    "name": "Telegram bot A",
    "status": "active",
    "spend_limit": "1000.0000000000",
    "usage": "0.0000000000",
    "total_spent": "0.0000000000",
    "usage_price_basis": "official_price",
    "usage_price_multiplier": "0.900000"
  }
}

Gruppen auflisten

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/groups \
  -H "Authorization: Bearer mg_partner_..."

Antwort

{"data":[{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A","status":"active","usage":"0.0000000000"}]}

Rufen Sie eine Gruppe ab oder aktualisieren Sie sie

Anfrage erhalten

curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..."

Erhalten Sie eine Antwort

{"data":{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A","spend_limit":"1000.0000000000","usage":"12.0000000000"}}

Update-Anfrage

curl -X PATCH https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \
  -H "Content-Type: application/json" \
  -d '{"name":"Telegram bot A production","status":"active","spend_limit":"2000.0000000000","usage_price_basis":"user_price","usage_price_multiplier":"1.200000"}'

Antwort aktualisieren

{"data":{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A production","spend_limit":"2000.0000000000","usage_price_basis":"user_price","usage_price_multiplier":"1.200000"}}

Eine Gruppe löschen

Eine nicht leere Gruppe wird nicht gelöscht. Verschieben oder löschen Sie zuerst alle Mitglieds-API-Schlüssel. andernfalls gibt die API HTTP zurück 409 mit group_not_empty.

Anfrage

curl -X DELETE https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort

{"data":{"deleted":true}}

Schlüssel werden entsprechend dem Fremdschlüsselverhalten der Datenbank getrennt. Überprüfen Sie die Mitgliedschaft vor dem Löschen.

Gruppennutzung zurücksetzen

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/reset-usage \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort

{"data":{"public_id":"GROUP_PUBLIC_ID","usage":"0.0000000000","total_spent":"8.5000000000"}}

Gruppenmitglieder auflisten

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members \
  -H "Authorization: Bearer mg_partner_..."

Antwort

{"data":[{"public_id":"KEY_PUBLIC_ID","name":"Telegram user 123","status":"active","usage":"3.2500000000","total_spent":"1.1400000000"}]}

Fügen Sie einer Gruppe einen Schlüssel hinzu

Anfrage

curl -X POST https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \
  -H "Content-Type: application/json" \
  -d '{"key_id":"KEY_PUBLIC_ID"}'

Antwort

Die Antwort ist die aktualisierte Gruppenmitgliederliste:

{"data":[{"public_id":"KEY_PUBLIC_ID","name":"Telegram user 123","status":"active"}]}

Einen Schlüssel aus einer Gruppe entfernen

Anfrage

curl -X DELETE https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members/KEY_PUBLIC_ID \
  -H "Authorization: Bearer mg_partner_..." \
  -H "Idempotency-Key: operation-unique-001" \

Antwort

{"data":{"removed":true}}

Gruppennutzung abrufen

Anfrage

curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/usage \
  -H "Authorization: Bearer mg_partner_..."

Antwort

{"data":{"group_id":"GROUP_PUBLIC_ID","usage":"12.0000000000","total_spent":"8.5000000000","usage_reset_at":"2026-08-01T00:00:00Z"}}

Gruppenstatistiken abrufen

from Und to Akzeptieren Sie nur UTC RFC3339-Zeitstempel mit der Endung Z (Sekundenbruchteile bis zu 6 Ziffern sind zulässig). Statistiken werden nur aus Aggregaten abgeschlossener Anforderungen berechnet, die mit einem Schlüssel versehen sind finished_at; Die aktuell offene Minute wird absichtlich ausgeschlossen, sodass die Ergebnisse um bis zu den Minutenaggregationsrhythmus verzögert sein können.

average_duration_ms ist die durchschnittliche vollständige Model Gate-Anfragedauer (duration_ms) über abgeschlossene Anfragen im ausgewählten Zeitraum. Es handelt sich nicht um die E2E-First-Token-Latenz, die Upstream-First-Token-Latenz oder den Gateway-Overhead. Das Partner API macht nur diesen expliziten Metriknamen verfügbar.

Anfrage

curl "https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/stats?from=2026-08-01T00:00:00Z&to=2026-08-05T23:59:59Z" \
  -H "Authorization: Bearer mg_partner_..."

Antwort

{
  "data": {
    "group_id": "GROUP_PUBLIC_ID",
    "requests": 120,
    "errors": 3,
    "input_tokens": 50000,
    "output_tokens": 12000,
    "cached_tokens": 8000,
    "cache_write_tokens": 1200,
    "reasoning_tokens": 2000,
    "cost": "8.5000000000",
    "average_duration_ms": "842.50",
    "from": "2026-08-01T00:00:00Z",
    "to": "2026-08-05T23:59:59Z"
  }
}

Erhalten Sie ein asynchrones Ergebnis

Anfrage

curl https://p-api.model-gate.com/api/v1/requests/01KZ... \
  -H "Authorization: Bearer mg_partner_..."

Antwort wird verarbeitet

{
  "data": {
    "request_id": "01KZ...",
    "status": "processing",
    "created_at": "2026-08-05T10:00:00Z",
    "started_at": "2026-08-05T10:00:00Z",
    "completed_at": null,
    "expires_at": "2026-08-06T10:00:00Z"
  }
}

Antwort abgeschlossen

{
  "data": {
    "request_id": "01KZ...",
    "status": "completed",
    "response_status": 200,
    "response_headers": {"Content-Type":"application/json"},
    "response": {"id":"resp_example","status":"completed"},
    "completed_at": "2026-08-05T10:00:05Z",
    "expires_at": "2026-08-06T10:00:00Z"
  }
}

Häufige Fehler

Ungültiger Partner API-Schlüssel – 401

{"error":{"type":"invalid_token","message":"Invalid Partner API key"}}

Ressource nicht gefunden – 404

{"error":{"type":"not_found","message":"API key not found"}}

Ungültige Anfrage – 422

{"error":{"type":"invalid_request","message":"limit must be an integer from 1 to 100"}}

Mutierende Partner API JSON-Körper sind auf 1 MiB begrenzt.

Idempotenzkonflikt – 409

Das gleiche Idempotency-Key wurde für eine andere Anfrage wiederverwendet. Generieren Sie einen neuen Schlüssel für eine neue logische Operation.

Tariflimit – 429

Die Antwort enthält error.code = partner_rate_limit_exceeded Und Retry-After. Versuchen Sie es erst nach der angegebenen Verzögerung erneut.

Methode nicht zulässig – 405

Der Partnerhost gibt einen JSON-Fehler plus HTTP zurück Allow Kopfzeile; es greift nie auf eine HTML-Fehlerseite zurück.

Regeln für Geschäftsberechtigungsprinzipale

Für ein Business Partner API-Token wird nur der bestätigte Organisationsinhaber akzeptiert. Mit Partner API erstellte Schlüssel verwenden diesen Eigentümer sowohl als Rechnungseigentümer als auch als Hauptkonto der Anmeldeinformationen. Die Mitarbeiter-Vorgesetzten-Zuordnung erfolgt im Webpanel. group_id, sofern angegeben, muss eine aktive Gruppe identifizieren, die dem Geschäftskonto gehört; Ungültige Werte geben HTTP zurück 422 und greifen Sie niemals auf einen nicht gruppierten Schlüssel zurück. Zu den Antworten im Anforderungsverlauf können Folgendes gehören: principal_user_id um den Anmeldeinformationsprinzipal unabhängig vom Abrechnungseigentum zu identifizieren.