Die API, wenn Sie lieber selbst aufrufen

1.Die API, wenn Sie lieber selbst aufrufen

Die Bibliothek ist nur eine dünne Hülle um einen einzigen Endpunkt. Rufen Sie ihn direkt auf, wenn Sie außerhalb von PHP arbeiten — dann müssen Sie die obigen Cache-Regeln allerdings selbst umsetzen und die Signatur prüfen.

Endpunkt

POST https://addonsmarket.com/api/license

Anfrage

HTTP

POST /api/licence HTTP/1.1
Host: addonsmarket.com
Content-Type: application/json
User-Agent: MonProduit/1.0

{
  "cle": "VOTRE_CLE",
  "url": "boutique.exemple.fr"
}

Was Sie senden

cle	string	Der Schlüssel des Käufers. Nur Buchstaben und Ziffern; alles andere entfernen wir, eingefügte Leerzeichen und Bindestriche schaden also nicht.
url	string	Der Host, auf dem Ihr Produkt läuft. Eine vollständige URL geht auch — wir behalten nur den Host. Entfernen Sie Port und führendes www. selbst, wenn die Antwort dem entsprechen soll, was Sie gesendet haben.

Antwort

JSON

{
  "donnees": {
    "ok": true,
    "motif": "",
    "domaine": "exemple.fr",
    "essai": false,
    "quand": "",
    "emis": 1790687453,
    "revalider": 1790773853,
    "sursis": 2592000,
    "hote": "boutique.exemple.fr"
  },
  "signature": "4p9JXJRfcB5R/LNEQwr/cwnVv1M5R1OdCNcU…"
}

Felder der Antwort

ok	bool	Ob das Produkt hier laufen darf.
motif	string	Warum nicht, wenn ok falsch ist. Siehe die Tabelle unten.
domaine	string	Die Domain, an die die Lizenz gebunden ist.
essai	bool	Entwicklungsschlüssel oder Testdomain.
quand	string	Wann der Schlüssel ersetzt oder widerrufen wurde.
emis	int	Wann wir geantwortet haben. Der Beginn der 30-tägigen Schonfrist.
revalider	int	Zeitstempel, vor dem Sie nicht erneut fragen dürfen.
sursis	int	Sekunden, die Sie dieses Urteil behalten dürfen, falls wir nicht mehr antworten.
hote	string	Der Host, zu dem wir geantwortet haben. Weisen Sie die Antwort zurück, wenn es nicht Ihrer ist.

HTTP-Codes

200	Ein signiertes Urteil. Beachten Sie: auch eine Ablehnung ist ein 200 — lesen Sie ok, nicht den Statuscode.
400	Schlüssel oder Host fehlt.
405	Alles außer POST oder OPTIONS.
429	Aufruflimit erreicht. Behalten Sie Ihr Urteil im Cache und versuchen Sie es später erneut — werten Sie das nie als Ablehnung.

Dreißig Aufrufe pro Minute und IP-Adresse. Werden die Cache-Regeln eingehalten, ruft ein Shop einmal am Tag auf; dieses Limit erreichen Sie also nur aus einem Lasttest oder einer Schleife, die ihren Cache vergessen hat.

Senden Sie einen User-Agent, der Ihr Produkt nennt. Einige Standard-Agenten von HTTP-Bibliotheken — der von urllib in Python etwa — werden gefiltert, bevor sie uns erreichen, und bekommen ein 403. Jede eigene Zeichenkette vermeidet das.

Etwas unklar?

Schreiben Sie uns aus Ihrem Autorenbereich. Eine Frage, die gestellt werden musste, heißt meistens, dass dieser Seite ein Absatz fehlt.

Autorenbereich