Add-ons auflisten
Was sich zusätzlich zum Tarif kaufen lässt: heute eine dedizierte Versand-IP.
Führt jeden der 3 Aufrufe in Ihrem Workspace aus.
GET /billing/add-ons
Was sich zusätzlich zum Tarif kaufen lässt: heute eine dedizierte Versand-IP.
Beispiel
Erfordert billing:read. eligibility sagt, ob der Workspace die Voraussetzungen für eine dedizierte IP erfüllt. Nötig sind der Business- oder Enterprise-Tarif und mindestens 100.000 gesendete E-Mails in einem Monat, weil eine dedizierte IP unter diesem Volumen schlechter zustellt als die gemeinsamen. reason nennt, was fehlt, plan oder volume.
curl "$OE/billing/add-ons" -H "$AUTH"{ "object": "list", "data": [{ "object": "add_on", "addOn": "dedicated-ip", "available": true, "status": null, "priceCents": 3999, "endsAt": null, "eligibility": { "eligible": false, "plan": "business", "monthlySends": 41200, "minimumMonthlySends": 100000, "reason": "volume" }, "ips": []}] }status ist null, bis der Workspace das Add-on hat, dann pending, während es eingerichtet wird, warming, active und releasing, sobald es abgebaut wird.
Nur der Inhaber des Workspace erreicht die Abrechnung: ein API-Schlüssel oder ein Zugriffstoken, das der Inhaber mit jeder Adresse verbunden hat. Das Token eines Mitglieds ist ein 403 owner_only, und ein Schlüssel oder Token, der auf bestimmte Adressen oder Domains beschränkt ist, ein 422 capability_unsupported.
Kaufen
Erfordert billing:write. POST /billing/add-ons/checkout gibt den Link zurück, über den die Person bezahlt. Sobald bezahlt ist, wird die IP eingerichtet und aufgewärmt.
curl -X POST "$OE/billing/add-ons/checkout" -H "$AUTH" -H 'content-type: application/json' \ -d '{ "addOn": "dedicated-ip" }'{ "object": "add_on_checkout", "addOn": "dedicated-ip", "url": "https://checkout.example.com/c/9Tn4wRb1xK7pQ2zd" }Ein Workspace, der es bereits hat, ist ein 409 add_on_already_active, einer, der die Voraussetzungen nicht erfüllt, ein 409 add_on_not_eligible, und wenn jede IP vergeben ist, ein 409 add_on_sold_out.
Über die API wird nichts bezahlt. Der Link öffnet die Seite des Zahlungsanbieters, auf der die Person bezahlt, die Karte ändert oder kündigt, wie sie es aus der App tut.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.
Kündigen
Erfordert billing:write. DELETE /billing/add-ons/dedicated-ip kündigt es zum Ende des bereits bezahlten Monats, den endsAt angibt. Danach wird die IP freigegeben, und E-Mails gehen wieder über die gemeinsamen IPs raus.
curl -X DELETE "$OE/billing/add-ons/dedicated-ip" -H "$AUTH"{ "object": "add_on", "addOn": "dedicated-ip", "status": "active", "endsAt": "2026-11-01T00:00:00.000Z" }Ein Workspace ohne das Add-on ist ein 409 add_on_not_active.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.