Automatische Verlängerung deaktivieren

POST/account/api/v1/auto-renewal/disable

Vorgang bewusst bestätigen

Dieser Vorgang kann Datensätze, Guthaben oder Diensteinstellungen ändern. Lesen Sie zuerst Umfang und Hinweise. Bei unklarem Ergebnis denselben Vorgang abfragen statt einen neuen zu starten.

Autorisierung

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Erforderliche Berechtigung	`renewals`
Accept	`application/json`
Content-Type	`application/json`
Idempotency-Key	16–100 Buchstaben, Ziffern, _ oder -. Für denselben Vorgang speichern und wiederverwenden.

Parameter

Name	Typ	Beschreibung
`Idempotency-Key` headerErforderlich	`string`	16–100 Buchstaben/Ziffern/_/-. Für Vorgang und Status denselben Wert behalten; nicht mit anderem Inhalt wiederverwenden.
`settings` bodyErforderlich	`object[]`	1–1000 eigene Guthabenverlängerungs-Einstellungen mit eindeutigen IDs. Karten-/PayPal-Einstellungen sind nicht verwaltbar.
`settings[].id` bodyErforderlich	`integer`	Eigene Einstellungs-ID aus auto_renewal_settings.
`settings[].revision` bodyErforderlich	`string`	64 Zeichen lange revision derselben Einstellungszeile.
`terms` bodyErforderlich	`boolean`	Zur ausdrücklichen Zustimmung muss der JSON-Wahrheitswert true gesendet werden, nicht die Zeichenfolge "true".

Anfrageinhalt

Ersetzen Sie YOUR_/FROM_ durch Werte aus Katalog, Angebot oder Umfang. Beispiele lassen die Zustimmung auf false; bestätigen Sie echte Vorgänge nur bewusst.

request.json

{
    "settings": [
        {
            "id": "YOUR_SETTING_ID",
            "revision": "FROM_SETTINGS_REVISION"
        }
    ],
    "terms": false
}

Anfragebeispiel

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --header 'Idempotency-Key: YOUR_SAVED_OPERATION_KEY' \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/auto-renewal/disable'

Beispiele werden hier nicht ausgeführt. Speichern Sie den API-Schlüssel in einer serverseitigen Umgebungsvariablen, nie in URLs oder Browsercode. Bereiten Sie request.json für POST vor.

Antworten

200Erfolgsantwort

application/json

{
    "ok": true,
    "data": {
        "state": "completed",
        "action": "disable",
        "settings": [
            {
                "id": 20,
                "proxy_id": 12345,
                "order_number": null,
                "active": false,
                "payment_method": "balance",
                "time_id": 101,
                "currency": "TRY",
                "next_renewal_date": "2030-02-01",
                "next_attempt_at": null,
                "last_status": "disabled",
                "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "managed_via_website": false,
                "timezone": "Europe/Istanbul"
            }
        ],
        "payment_method": "balance",
        "configuration_only": true,
        "immediate_charge": false,
        "balance_changed": false,
        "proxy_expiry_changed": false,
        "provider_requests": 0,
        "payment_requests": 0,
        "consent_version": "balance_current_pricing_v1",
        "api_key_revocation_stops_existing_renewals": false,
        "source": "existing_website_auto_renewal",
        "completed_at": "2030-01-01T12:00:00+00:00",
        "replayed": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

Antwortfelder und Typen

Name	Typ	Beschreibung
`ok`	`boolean`	Erfolgskennzeichen; bei false error.code prüfen.
`data`	`object`	Vorgangsspezifisches Ergebnis; Beispiele sind synthetisch und dienen der Veranschaulichung.
`data.state`	`string`	Datensatz-/Vorgangsstatus. accepted bedeutet nicht geliefert, completed keinen Verbindungstest.
`data.action`	`string`	Vorgangsspezifischer Wert für action. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.settings`	`array`	Vorgangsspezifischer Wert für settings. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.settings[]`	`object`	Vorgangsspezifischer Wert für settings. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.settings[].id`	`integer`	Zugehörige ARNPROXY-Datensatz-ID statt interner Anbieter-ID verwenden.
`data.settings[].proxy_id`	`integer`	Zugehörige ARNPROXY-Datensatz-ID statt interner Anbieter-ID verwenden.
`data.settings[].order_number`	`string\|null`	Angezeigte Bestellnummer, nicht mit Feldern für id austauschbar.
`data.settings[].active`	`boolean`	Ob Datensatz aktiv ist; inaktive historische Einstellungen können gespeichert bleiben.
`data.settings[].payment_method`	`string`	Guthaben/Karte/PayPal; API-Einstellungsverwaltung unterstützt nur Guthaben.
`data.settings[].time_id`	`integer`	Lokale Laufzeit-/GB-Plan-ID, keine Anzahl von Tagen oder GB.
`data.settings[].currency`	`string`	Kontowährung der Transaktion: TRY oder USD.
`data.settings[].next_renewal_date`	`string`	Gespeicherter Verlängerungstag/Neuversuchszeitpunkt, kein Nachweis einer Abbuchung.
`data.settings[].next_attempt_at`	`string\|null`	Gespeicherter Verlängerungstag/Neuversuchszeitpunkt, kein Nachweis einer Abbuchung.
`data.settings[].last_status`	`string`	Vorgangsspezifischer Wert für last status. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.settings[].revision`	`string`	Aktualitätskennung unverändert an die zugehörige Änderung/Preisbestätigung zurückgeben.
`data.settings[].managed_via_website`	`boolean`	Vorgangsspezifischer Wert für managed via website. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.settings[].timezone`	`string`	Zeitzone der zugehörigen Datumsfelder; null bedeutet nicht verifiziert.
`data.payment_method`	`string`	Guthaben/Karte/PayPal; API-Einstellungsverwaltung unterstützt nur Guthaben.
`data.configuration_only`	`boolean`	Vorgangsspezifischer Wert für configuration only. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.immediate_charge`	`boolean`	Gemeldete Vorgangswirkung; automatische Verlängerung kann später getrennte Abbuchungen verursachen.
`data.balance_changed`	`boolean`	Gemeldete Vorgangswirkung; automatische Verlängerung kann später getrennte Abbuchungen verursachen.
`data.proxy_expiry_changed`	`boolean`	Gemeldete Vorgangswirkung; automatische Verlängerung kann später getrennte Abbuchungen verursachen.
`data.provider_requests`	`integer`	Vorgangsspezifischer Wert für provider requests. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.payment_requests`	`integer`	Vorgangsspezifischer Wert für payment requests. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.consent_version`	`string`	Vorgangsspezifischer Wert für consent version. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.api_key_revocation_stops_existing_renewals`	`boolean`	false: Schlüsselwiderruf deaktiviert automatische Verlängerungen nicht; Einstellung separat abschalten.
`data.source`	`string`	Datenquelle; lokale Datensätze und Live-Anbieterabfragen sind unterschiedliche Nachweise.
`data.completed_at`	`string`	Zeitstempel im vom API gelieferten Format; Beispieldaten sind synthetisch.
`data.replayed`	`boolean`	Gespeichertes Ergebnis desselben Vorgangs, kein Beweis für neue Abbuchung/Aktion.
`meta`	`object`	Metadaten zu Anfragezuordnung und Datenquelle.
`meta.request_id`	`string`	Kennung dieser HTTP-Anfrage, kein Vorgangsschlüssel oder Bestell-ID.
`meta.phase`	`string`	Vorgangsspezifischer Wert für phase. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`meta.source`	`string`	Datenquelle; lokale Datensätze und Live-Anbieterabfragen sind unterschiedliche Nachweise.

Fehlerantwort

HTTP 401 · INVALID_API_KEY

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

Authentifizierung und Validierung können eine Anfrage vor der Ausführung ablehnen. Beachten Sie die Fehlerreferenz und bewahren Sie request_id für den Support auf. Senden Sie niemals Schlüssel oder Passwörter. Fehler & Limits →

Verhalten & wichtige Hinweise

Diese Ressourcen konfigurieren nur vorhandene Guthabenverlängerung, ohne sofortige Abbuchung/Verlängerung. Bestehender Cron verlängert später zum aktuellen Preis. Schlüsselwiderruf deaktiviert Einstellungen nicht; separat abschalten. Karte/PayPal bleiben Website-Sache. Keine Promo, länderweise Mengenrabatte und vollständige IPv6-Bestellauswahl bleiben. Abschalten macht begonnene/abgeschlossene Verlängerung nicht rückgängig.
Timeout/5xx beweist keinen Schreibfehler. Ursprünglichen Idempotency-Key für den Status verwenden. Nicht mit neuem Schlüssel wiederholen; GET sendet die Änderung nicht erneut.
Eigene Guthabeneinstellung auch bei abgelaufenem Proxy abschaltbar. Abschalten nimmt begonnene/abgeschlossene Verlängerung oder Abbuchung nicht zurück.

Denselben Vorgang verfolgenEinstellungsvorgang prüfen →