L’API, se preferisci chiamarla da solo

1.L’API, se preferisci chiamarla da solo

La libreria è solo un involucro sottile attorno a un unico endpoint. Chiamalo direttamente se lavori fuori da PHP, ma allora dovrai implementare tu stesso le regole di cache qui sopra e verificare la firma.

Endpoint

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

Richiesta

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"
}

Che cosa invii

cle	string	La chiave dell’acquirente. Solo lettere e cifre; togliamo il resto, quindi spazi e trattini incollati non danno fastidio.
url	string	L’host su cui gira il tuo prodotto. Va bene anche un URL completo: teniamo solo l’host. Togli tu stesso la porta e il www. iniziale se vuoi che la risposta corrisponda a ciò che hai inviato.

Risposta

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…"
}

Campi della risposta

ok	bool	Se il prodotto può funzionare qui.
motif	string	Perché no, quando ok è falso. Vedi la tabella più sotto.
domaine	string	Il dominio a cui è legata la licenza.
essai	bool	Chiave di sviluppo o dominio di test.
quand	string	Quando la chiave è stata sostituita o revocata.
emis	int	Quando abbiamo risposto. L’inizio della proroga di 30 giorni.
revalider	int	Marca temporale prima della quale non devi richiedere.
sursis	int	Secondi per cui puoi conservare questo verdetto se smettiamo di rispondere.
hote	string	L’host su cui abbiamo risposto. Rifiuta la risposta se non è il tuo.

Codici HTTP

200	Un verdetto firmato. Attenzione: anche un rifiuto è un 200 — leggi ok, non il codice di stato.
400	Chiave o host mancante.
405	Qualsiasi cosa diversa da POST o OPTIONS.
429	Limite di chiamate raggiunto. Conserva il verdetto in cache e riprova più tardi: non trattarlo mai come un rifiuto.

Trenta chiamate al minuto per indirizzo IP. Rispettando le regole di cache, un negozio fa una chiamata al giorno: raggiungerai questo limite solo da un test di carico o da un ciclo che ha dimenticato la cache.

Invia uno User-Agent che nomini il tuo prodotto. Alcuni agenti predefiniti di librerie HTTP, come quello di urllib in Python, vengono filtrati prima di arrivarci e ricevono un 403. Qualsiasi stringa personalizzata lo evita.

Qualcosa non è chiaro?

Scrivici dalla tua area autore. Una domanda che è stato necessario porre significa di solito che a questa pagina manca un paragrafo.

Autore