Listoni shtesat
Çfarë mund të blihet përveç planit: sot, një IP e dedikuar dërgimi.
Ekzekuton cilëndo nga 3 thirrjet në hapësirën tuaj të punës.
GET /billing/add-ons
Çfarë mund të blihet përveç planit: sot, një IP e dedikuar dërgimi.
Shembull
Kërkon billing:read. eligibility tregon nëse hapësira e punës i plotëson kushtet për një IP të dedikuar. Duhet plani Business ose Enterprise dhe të paktën 100 000 emaile të dërguara në një muaj, sepse nën këtë vëllim një IP e dedikuar dorëzon më keq se të përbashkëtat. reason tregon çfarë mungon, plan ose 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 është null derisa hapësira e punës ta ketë shtesën, pastaj pending ndërsa konfigurohet, warming, active, dhe releasing sapo të fillojë të hiqet.
Vetëm pronari i hapësirës së punës e arrin faturimin: një çelës API, ose një token aksesi që pronari e lidhi me çdo adresë. Token-i i një anëtari jep 403 owner_only, dhe një çelës ose token i kufizuar në adresa ose domene të caktuara jep 422 capability_unsupported.
Blijeni
Kërkon billing:write. POST /billing/add-ons/checkout kthen lidhjen ku personi paguan. Pasi të paguhet, IP-ja konfigurohet dhe ngrohet.
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" }Një hapësirë pune që e ka tashmë jep 409 add_on_already_active, një që nuk i plotëson kushtet jep 409 add_on_not_eligible, dhe kur të gjitha IP-të janë të zëna jep 409 add_on_sold_out.
Asgjë nuk paguhet përmes API-së. Lidhja hap faqen e ofruesit të pagesave, ku personi paguan, ndryshon kartën ose anulon, ashtu si nga aplikacioni.
Një token qasjeje OAuth ka nevojë për një kod verifikimi për këtë thirrje. Derisa aplikacioni të ketë verifikuar një në 60 minutat e fundit, thirrja përgjigjet me 403 step_up_required dhe nuk ndryshon asgjë. Një çelësi API nuk i kërkohet kurrë. Faqja Autentikimi tregon si të kërkoni një kod dhe ta verifikoni.
Anulojeni
Kërkon billing:write. DELETE /billing/add-ons/dedicated-ip e anulon në fund të muajit të paguar tashmë, të cilin e jep endsAt. Pastaj IP-ja lirohet dhe posta del sërish përmes IP-ve të përbashkëta.
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" }Një hapësirë pune pa shtesën jep 409 add_on_not_active.
Një token qasjeje OAuth ka nevojë për një kod verifikimi për këtë thirrje. Derisa aplikacioni të ketë verifikuar një në 60 minutat e fundit, thirrja përgjigjet me 403 step_up_required dhe nuk ndryshon asgjë. Një çelësi API nuk i kërkohet kurrë. Faqja Autentikimi tregon si të kërkoni një kod dhe ta verifikoni.