GET Bestellstatus und letzte Rechnungsadresse lesen
/api/v1/account/orders/checkout
Lesen Sie Ihre zuletzt verwendete Rechnungsadresse, offene Bestellung und die aktuelle Verfügbarkeit des Bestellabschlusses. Nur die normale verifizierte Eigentümersitzung ist zugelassen. Workspace-Mitgliedschaft und Supportzugriff berechtigen nicht zur Bestellung.
Auf dieser Seite
Zugriff und Rechte
Lesen Sie Ihre zuletzt verwendete Rechnungsadresse, offene Bestellung und die aktuelle Verfügbarkeit des Bestellabschlusses. Nur die normale verifizierte Eigentümersitzung ist zugelassen. Workspace-Mitgliedschaft und Supportzugriff berechtigen nicht zur Bestellung.
Browsersitzung: Cookie __Host-mb_session.
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| workspace_id | URL-Parameter | string; {"format":"uuid"} | Nein | Begrenzen Sie die Liste auf einen zugänglichen Arbeitsbereich. |
Anfragekörper
Kein Anfragekörper.
Antworten
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | PackageOrderCheckout | Ja | — |
| $.account_id | string | Ja | — |
| $.address | BillingAddress | null | Ja | — |
| $.address (anyOf 1) | BillingAddress | Nein | Internationale Rechnungsadresse. Pflichtangaben für Postleitzahl und Region folgen dem Land; Unternehmen benötigen einen Firmennamen. Eine angegebene Steuerkennung muss vor ihrer steuerlichen Berücksichtigung vom Anbieter geprüft sein. |
| $.address (anyOf 1).city | string | Ja | — |
| $.address (anyOf 1).company | string | Nein | — |
| $.address (anyOf 1).country | string; {"maxLength":2,"minLength":2,"pattern":"^[A-Z]{2}$"} | Ja | — |
| $.address (anyOf 1).kind | string; {"enum":["personal","business"]} | Ja | — |
| $.address (anyOf 1).line1 | string | Ja | — |
| $.address (anyOf 1).line2 | string | Nein | — |
| $.address (anyOf 1).name | string | Ja | — |
| $.address (anyOf 1).postal_code | string; {"maxLength":32} | Ja | — |
| $.address (anyOf 1).state | string; {"maxLength":64} | Nein | — |
| $.address (anyOf 1).tax_id | string | Nein | — |
| $.address (anyOf 1).tax_id_type | string | Nein | — |
| $.address (anyOf 2) | null | Nein | — |
| string | Ja | — | |
| $.open_order | PackageOrder | null | Ja | — |
| $.open_order (anyOf 1) | PackageOrder | Nein | — |
| $.open_order (anyOf 1).account_email | string | Ja | — |
| $.open_order (anyOf 1).account_id | string | null | Ja | — |
| $.open_order (anyOf 1).account_id (anyOf 1) | string | Nein | — |
| $.open_order (anyOf 1).account_id (anyOf 2) | null | Nein | — |
| $.open_order (anyOf 1).activation_status | string; {"enum":["not_activated"]} | Ja | — |
| $.open_order (anyOf 1).cancelled_at | string; {"format":"date-time"} | null | Ja | — |
| $.open_order (anyOf 1).cancelled_at (anyOf 1) | string; {"format":"date-time"} | Nein | — |
| $.open_order (anyOf 1).cancelled_at (anyOf 2) | null | Nein | — |
| $.open_order (anyOf 1).created_at | string; {"format":"date-time"} | Ja | — |
| $.open_order (anyOf 1).id | string | Ja | — |
| $.open_order (anyOf 1).invoice_status | string; {"enum":["not_created"]} | Ja | — |
| $.open_order (anyOf 1).number | string | Ja | — |
| $.open_order (anyOf 1).payment_status | string; {"enum":["not_requested"]} | Ja | — |
| $.open_order (anyOf 1).revision | integer | Ja | — |
| $.open_order (anyOf 1).snapshot | PackageOrderSnapshot | Ja | — |
| $.open_order (anyOf 1).snapshot.address | BillingAddress | Ja | Internationale Rechnungsadresse. Pflichtangaben für Postleitzahl und Region folgen dem Land; Unternehmen benötigen einen Firmennamen. Eine angegebene Steuerkennung muss vor ihrer steuerlichen Berücksichtigung vom Anbieter geprüft sein. |
| $.open_order (anyOf 1).snapshot.address.city | string | Ja | — |
| $.open_order (anyOf 1).snapshot.address.company | string | Nein | — |
| $.open_order (anyOf 1).snapshot.address.country | string; {"maxLength":2,"minLength":2,"pattern":"^[A-Z]{2}$"} | Ja | — |
| $.open_order (anyOf 1).snapshot.address.kind | string; {"enum":["personal","business"]} | Ja | — |
| $.open_order (anyOf 1).snapshot.address.line1 | string | Ja | — |
| $.open_order (anyOf 1).snapshot.address.line2 | string | Nein | — |
| $.open_order (anyOf 1).snapshot.address.name | string | Ja | — |
| $.open_order (anyOf 1).snapshot.address.postal_code | string; {"maxLength":32} | Ja | — |
| $.open_order (anyOf 1).snapshot.address.state | string; {"maxLength":64} | Nein | — |
| $.open_order (anyOf 1).snapshot.address.tax_id | string | Nein | — |
| $.open_order (anyOf 1).snapshot.address.tax_id_type | string | Nein | — |
| $.open_order (anyOf 1).snapshot.billing | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown | array<object> | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[] | object | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].amount | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].tax_rate_details | object | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].tax_rate_details.country | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].tax_rate_details.percentage_decimal | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].tax_rate_details.state | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].tax_rate_details.tax_type | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].taxability_reason | string | Ja | — |
| $.open_order (anyOf 1).snapshot.breakdown[].taxable_amount | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.calculation_id | string | Ja | — |
| $.open_order (anyOf 1).snapshot.catalog_revision | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.config_version | string | Ja | — |
| $.open_order (anyOf 1).snapshot.currency | string | Ja | — |
| $.open_order (anyOf 1).snapshot.expires_at | string; {"format":"date-time"} | Ja | — |
| $.open_order (anyOf 1).snapshot.language | string | Ja | — |
| $.open_order (anyOf 1).snapshot.net_cents | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.payment_method | string | Ja | — |
| $.open_order (anyOf 1).snapshot.plan | PricingPlan | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.id | string; {"enum":["free","essentials","pro","business","enterprise"]} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.monthly_cents | integer | null; {"minimum":0,"maximum":1000000000} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.yearly_cents | integer | null; {"minimum":0,"maximum":1000000000} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.values | object | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention | PlanRetention | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.raw | integer; {"minimum":1,"maximum":30} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.minute | integer; {"minimum":1,"maximum":30} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.quarter_hour | integer; {"minimum":1,"maximum":365} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.hour | integer; {"minimum":1,"maximum":1095} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.text | integer; {"minimum":1,"maximum":7} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan.retention.logs | integer; {"minimum":1,"maximum":30} | Ja | — |
| $.open_order (anyOf 1).snapshot.plan_id | string | Ja | — |
| $.open_order (anyOf 1).snapshot.profile_revision | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.tax_cents | integer | Ja | — |
| $.open_order (anyOf 1).snapshot.tax_id_verified | boolean | Ja | — |
| $.open_order (anyOf 1).snapshot.terms | object | Ja | — |
| $.open_order (anyOf 1).snapshot.terms_version | string | Ja | — |
| $.open_order (anyOf 1).snapshot.total_cents | integer | Ja | — |
| $.open_order (anyOf 1).status | string; {"enum":["received","cancelled"]} | Ja | — |
| $.open_order (anyOf 2) | null | Nein | — |
| $.profile_revision | integer | Ja | — |
| $.ready | boolean | Ja | — |
| $.terms | object | Ja | — |
| $.terms.body | string | Ja | — |
| $.terms.renewal | string | Ja | — |
| $.terms_version | string | Ja | — |
{
"account_id": "00000000-0000-4000-8000-000000000002",
"email": "owner@example.test",
"ready": false,
"profile_revision": 0,
"address": null,
"open_order": null,
"terms": {
"body": "Example order terms for this API response: the selected contract starts upon later activation after confirmed payment. Publish complete terms before accepting real orders.",
"renewal": "Example: monthly term, automatic renewal according to the accepted conditions."
},
"terms_version": "0000000000000000000000000000000000000000000000000000000000000000"
}| Stabile Fehlercodes |
|---|
| unauthorized |
| invalid_credential |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 401,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| order_forbidden |
| csrf |
| csrf_failed |
| invalid_origin |
| owner_required |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 403,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| order_not_found |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 404,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| session_context_changed |
| quote_pending |
| order_conflict |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 409,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| invalid_order |
| tax_id_unverified |
| tax_region_unavailable |
| invalid_cursor |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 422,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| tax_rate_limited |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 429,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| ordering_unavailable |
| tax_unavailable |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Retry-After | string; {"pattern":"^[0-9]+$"} | Sekunden bis zur Wiederholung. Bewahren Sie unterstützte Idempotenzkennungen und beachten Sie die Änderungsregeln der Operation. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 503,
"title": "Demo error",
"type": "about:blank"
}Wiederholungen und asynchrone Aufträge
Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
Anfragebeispiele
Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.
Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.
curl --request GET --cookie '__Host-mb_session=<session>' --header 'Origin: https://metribeacon.com' --header 'X-CSRF-Token: <csrf>' --header 'X-MetriBeacon-Session-Context: <context>' --header 'Content-Type: application/json' --header 'Idempotency-Key: 00000000-0000-4000-8000-000000000002' 'https://metribeacon.com/api/v1/account/orders/checkout'import requests
response = requests.request('GET', 'https://metribeacon.com/api/v1/account/orders/checkout', cookies={'__Host-mb_session': '<session>'}, headers={'Origin': 'https://metribeacon.com', 'X-CSRF-Token': '<csrf>', 'X-MetriBeacon-Session-Context': '<context>', 'Idempotency-Key': '00000000-0000-4000-8000-000000000002'}, json=None)
response.raise_for_status()const response = await fetch('/api/v1/account/orders/checkout', {method: 'GET', credentials: 'same-origin', headers: {'Content-Type': 'application/json', 'X-CSRF-Token': '<csrf>', 'X-MetriBeacon-Session-Context': '<context>', 'Idempotency-Key': '00000000-0000-4000-8000-000000000002'}, });package main
import (
"net/http"
"strings"
)
func main() {
req, _ := http.NewRequest("GET", "https://metribeacon.com/api/v1/account/orders/checkout", strings.NewReader(""))
req.Header.Set("Cookie", "__Host-mb_session=<session>")
req.Header.Set("Origin", "https://metribeacon.com")
req.Header.Set("X-CSRF-Token", "<csrf>")
req.Header.Set("X-MetriBeacon-Session-Context", "<context>")
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "00000000-0000-4000-8000-000000000002")
response, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer response.Body.Close()
}
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- GET Paketbestellungen auflisten
Listen Sie Bestellungen mit Status-, Paket- und Textfilter sowie Cursor-Pagination mit 50 Zeilen auf. Kundensitzungen sehen nur eigene Bestellungen, Betreiber am Betreiberendpunkt alle Konten. Zusammenfassungen enthalten weder Rechnungsadressen noch vollständige Bedingungen.
- POST Paket kostenpflichtig bestellen
Geben Sie nach Zustimmung zur exakten Bedingungsversion eine gültige Bestellung ab. Verwenden Sie je Abgabe einen neuen UUID-Idempotency-Key und denselben Schlüssel bei manuellen Wiederholungen nach unklarer Antwort. Andere Inhalte mit demselben Schlüssel werden abgelehnt. Je Konto ist höchstens eine offene Bestellung erlaubt. Eine verschlüsselte Mailwarteschlange versendet die Eingangsbestätigung; die Rechnungsadresse wird erst mit erfolgreicher Abgabe aktualisiert. Preise, Steuer, Adresse und Bedingungen bleiben unveränderlich. Rechnung, Zahlung und Aktivierung warten auf die spätere NextOffice-Anbindung. Bisherige Paketgrenzen und Aufbewahrung bleiben unverändert.
- POST Bestellpreis und Steuern berechnen
Berechnen Sie ausdrücklich den Endpreis aus aktuellem Nettopreis und Rechnungsadresse. Stripe Tax ermittelt die Steuer; nicht unterstützte Gebiete, fehlende Konfiguration und ungeprüfte Steuerkennungen sperren den Abschluss. Berechnungen gelten höchstens 30 Minuten, binden alle Bestellangaben und werden kontogebunden wiederverwendet. Grenzen: zehn Anbieterabrufe je Konto/Stunde und 200 täglich insgesamt. Es entstehen keine Zahlung, Rechnung, Abonnement, Steuerbuchung oder Paketfreischaltung.