Entwickle mit der AlwaysCompleted-API
Binde AlwaysCompleted in deinen serverseitigen Ablauf ein, um Services abzurufen, Bestellungen aufzugeben und ihren Fortschritt zu verfolgen. Dieser Leitfaden führt dich von deiner ersten lesenden Anfrage zu den wichtigen Prüfungen beim Anlegen von Bestellungen. Halte die API-Referenz mit den vollständigen Parameterlisten und Antwortbeispielen geöffnet.
Die Anbindung vorbereiten
- Erstelle ein Konto und verwende den API-Schlüssel deines Kontos in deiner serverseitigen Konfiguration.
- Lies den Servicekatalog und die Bedingungen der Services, die du anbieten möchtest. Anforderungen, verfügbare Optionen und Bestellgrenzen hängen vom ausgewählten Service ab.
- Sende Anfragen aus deinem eigenen Backend über HTTPS. Lass die normale TLS-Zertifikatsprüfung aktiviert.
- Speichere den API-Schlüssel sicher auf deinem Server. Halte ihn aus öffentlichen Seiten, Browser-JavaScript, Screenshots und geteilten Codebeispielen heraus.
Die erste lesende Anfrage senden
Der dokumentierte Endpunkt akzeptiert POST-Anfragen und gibt JSON zurück. Das offizielle Anfragebeispiel verwendet URL-kodierte Formularparameter. Jede Aktion enthält deinen API-Schlüssel und einen Aktionsnamen.
POST https://alwayscompleted.com/api/v2
key=YOUR_API_KEY&action=services
Ersetze den Platzhalter nur in deiner serverseitigen Konfiguration. Die Aktion services liest den Katalog; sie erstellt keine Bestellung. Nutze ihre Antwort, um Service-IDs zu bestimmen und die verfügbaren Felder zu prüfen, bevor du dein Bestellformular erstellst.
Aktuelle Service- und Kontoinformationen nutzen
Die Serviceliste dokumentiert für jeden Service Name, Typ, Kategorie, Preis, Mindest- und Höchstmenge sowie Angaben zur Refill- und Stornierungsverfügbarkeit. Gleiche die gewählte Service-ID mit ihrer aktuellen Beschreibung und ihren Anforderungen ab. Nutze die zurückgegebenen Daten bei der Vorbereitung einer Bestellung, statt Beispiel-IDs oder Preise aus Dokumentationsbeispielen zu kopieren.
Nutze action=balance, um dein Kontoguthaben und dessen Währung abzurufen. Betrachte Beispielbeträge in der Referenz als Musterdaten. Deine Anwendung sollte die tatsächliche Antwort anzeigen und Fehler behandeln, bevor sie fortfährt.
Änderungen an einem zwischengespeicherten Katalog behandeln
Prüfe beim Aktualisieren eines zwischengespeicherten Katalogs auf entfernte Service-IDs und geänderte Preise oder Mengengrenzen, bevor du gespeicherte Optionen wieder verfügbar machst. Fehlt eine ausgewählte ID in der aktuellen Antwort, pausiere diese Bestellung zur Prüfung, statt einen Service mit ähnlichem Namen auszuwählen. Ändert sich ein Preis, Typ oder Mengenlimit, aktualisiere dein Formular und prüfe die Auswahl erneut, bevor du action=add sendest. Speichere die geprüften Servicedetails mit deinem lokalen Bestelldatensatz, damit spätere Fragen auf die Auswahl zurückgeführt werden können, die deine Anwendung tatsächlich geprüft hat.
Bestellungen bewusst anlegen
Um eine Bestellung anzulegen, sende action=add mit der ausgewählten Service-ID und den für diesen Servicetyp erforderlichen Feldern. Eine Bestellung vom Typ Default verwendet link und quantity; andere Typen haben andere Parameter. Prüfe vor dem Absenden den passenden Abschnitt der Referenz.
Wenn die Erstellung erfolgreich ist, speichere die zurückgegebene Bestell-ID zusammen mit deinem eigenen Bestelldatensatz. Bei einer Zeitüberschreitung oder einer unklaren Antwort prüfe das Ergebnis, bevor du die Anfrage erneut sendest. Das blinde Wiederholen einer add-Anfrage kann ein unbeabsichtigtes Duplikat erzeugen. Nutze das Anlegen einer Bestellung niemals als automatischen Verbindungstest.
Bestellungen und unterstützte Folgeanfragen verfolgen
Nutze action=status mit order für eine einzelne Bestellung oder orders mit durch Kommas getrennten IDs für eine Gruppe von bis zu 100. Die dokumentierte Antwort enthält status, charge, start_count, remains und currency. Prüfe jedes Ergebnis: Eine Sammelantwort kann einen Fehler für eine einzelne ID enthalten.
Refill und Stornierung sind Anfragen, die von der Verfügbarkeit und den Bedingungen des ausgewählten Services abhängen. Nutze action=refill, um Refill anzufordern, action=refill_status, um es zu verfolgen, und action=cancel, um eine Stornierung anzufragen. Die dokumentierten Sammelvarianten akzeptieren bis zu 100 IDs. Das Absenden einer Anfrage garantiert nicht, dass Refill oder Stornierung genehmigt werden.
Deine Integration fortsetzen
Nutze die vollständige API-Referenz für die genauen Aktionsparameter und Beispiele. Wenn du einen Serviceablauf für Kunden entwickelst, lies AlwaysCompleted für Wiederverkäufer. Prüfe die Bedingungen und Richtlinien zusammen mit der Beschreibung jedes Services, bevor du Kundenbestellungen annimmst.