Skip to main content
AceDataCloud verfügt derzeit über keinen aggregierten Endpunkt /api/v1/distribution/. Die Empfehlungsprämien-Daten bestehen aus vier Gruppen von Schnittstellen für Status, Verlauf, Stufen und Einlösung; rufen Sie die erforderlichen Ressourcen auf und vermeiden Sie die Abhängigkeit von einer nicht vorhandenen zusammengefassten Antwort.

​
Vorbereitung

  1. Erstellen und speichern Sie im Account-Token-Dashboard einen Account Token.
  2. Verwenden Sie GET /api/v1/platform-tokens/me/, um die UUID des aktuellen Kontos abzurufen.

​
Verfügbare Schnittstellen

​
Beispiele für schreibgeschützte Anfragen

Die Form der in der Produktionsumgebung verifizierten Antworten lautet:
  • status, history, level, redemption list: {count, items};
  • redemption preview: ein einzelnes Objekt, das Felder wie eligible, reason, reward_amount, credit_amount, credits_per_usd, currency, package, global_application usw. enthält.
Status- und Verlaufseinträge können entsprechend der Empfehlungsrisikokontrolle, Kompensation und Prämienregeln erweitert werden; Clients sollten sie nach Bedarf lesen und sich nicht auf aggregierte Felder wie referral_url, recent_orders, withdrawable_balance usw. verlassen, die in alten Dokumenten aufgeführt, aber von der Schnittstelle nicht zurückgegeben werden.
Sowohl die Initialisierung als auch die Einlösung sind Schreibvorgänge. Produktionsskripte sollten zuerst den Status über schreibgeschützte Schnittstellen prüfen und für Einlösungsanfragen einen eindeutigen idempotency_key dauerhaft speichern; Einlösungen mit unbekanntem Ergebnis dürfen nicht automatisch erneut versucht werden.

​
Verwandte Seiten

​
Aufschlagsbestellungen von Unterseiten

Für Unterseitenbestellungen, auf die die neuen Regeln angewendet werden, wird die Empfehlungsprovision auf Grundlage des rabattierten Basispreises berechnet, während die gesamte Differenz des Aufschlags nach Rabatt dem Betreiber der Unterseite zum Zeitpunkt der Bestellungserstellung zusteht. Die beiden Prämienteile desselben Begünstigten werden im ursprünglichen Vertriebsdatensatz zusammengeführt, und der Vertriebsverlauf zeigt die Zusammensetzung an; Bestellungen ohne Aufschlag und historische Bestellungen behalten die ursprünglichen Regeln bei. Wenn beispielsweise der Basispreis 100 und der Preis nach Aufschlag 120 beträgt, der Betreiber der Unterseite zugleich der einzige Empfehlende ist und der Anteil 10 % beträgt, beläuft sich die Prämie für diese Bestellung auf 10 + 20 = 30. Wenn der Betreiber der Unterseite und der Empfehlende nicht dieselbe Person sind, erhalten beide jeweils die entsprechende Prämie. Die Barauszahlung wird weiterhin manuell von der Plattform abgewickelt. Die Plattform zieht den diesmal verfügbaren Betrag vom ursprünglichen Prämienkonto ab und nimmt anschließend die manuelle Auszahlung vor; bereits in Punkte eingelöste Beträge können nicht erneut bar ausgezahlt werden. Falls nach einer Rückerstattung ein Prämienfehlbetrag entsteht, wird dieser zunächst mit nachfolgenden Prämien verrechnet.