API: servizi, prezzi, ordini, stato e refill
Parametri e risposte delle sole azioni pubbliche disponibili.
Ultimo aggiornamento:
Come funziona, passo dopo passo
- Richiedi services per ottenere l’array del catalogo: ID service, descrizione, piattaforma, min, max, rate, price_per_item, pricing_unit, refill, cancel e valuta EUR. rate è il riferimento per 1000; non è un preventivo per ogni quantità.
- Richiedi balance per il saldo. Per ordinare usa add con service, link e quantity; conserva order dalla risposta insieme a charge e currency. Il prezzo è calcolato sul server con il motore del sito, inclusi i minimi applicabili.
- Assegna idempotency_key a ogni acquisto e riutilizza la stessa chiave nei tentativi di quell’acquisto. È facoltativa, limitata a 120 caratteri ed è associata alla chiave API: non cambiarla durante un retry.
- Per status passa order o orders con gli ID numerici, fino a 100 separati da virgole. La consultazione riguarda solo i tuoi ordini API. start_count e remains sono attualmente null.
- Per refill passa order di un tuo ordine API: se accettato ricevi un identificativo refill. Non sono pubblicate azioni di verifica dello stato refill o di cancellazione; il campo cancel del catalogo non è un endpoint operativo.
Attenzione
Gli stati API sono Pending, In progress, Processing, Partial, Completed e Canceled. Non stimare quantità residue dai campi null e non presumere che una richiesta refill sia sempre accettata.
Esempi API
services
curl --request POST https://nexwa.store/api/v2 \
--header "Authorization: Bearer ${NEXWA_API_KEY}" \
--data-urlencode "action=services"balance
curl --request POST https://nexwa.store/api/v2 \
--header "Authorization: Bearer ${NEXWA_API_KEY}" \
--data-urlencode "action=balance"add
curl --request POST https://nexwa.store/api/v2 \
--header "Authorization: Bearer ${NEXWA_API_KEY}" \
--data-urlencode "action=add" \
--data-urlencode "service=${NEXWA_SERVICE_ID}" \
--data-urlencode "link=${NEXWA_TARGET_URL}" \
--data-urlencode "quantity=${NEXWA_QUANTITY}" \
--data-urlencode "idempotency_key=${NEXWA_PURCHASE_ID}"status
curl --request POST https://nexwa.store/api/v2 \
--header "Authorization: Bearer ${NEXWA_API_KEY}" \
--data-urlencode "action=status" \
--data-urlencode "order=${NEXWA_ORDER_ID}"refill
curl --request POST https://nexwa.store/api/v2 \
--header "Authorization: Bearer ${NEXWA_API_KEY}" \
--data-urlencode "action=refill" \
--data-urlencode "order=${NEXWA_ORDER_ID}"Riferimento API pubblico
| Azione | Parametri | Risposta |
|---|---|---|
services | action | Array<{service, name, category, platform, type, rate, price_per_item, pricing_unit, description, min, max, refill, cancel, currency}> |
balance | action | {balance, currency} |
add | action, service, link, quantity, idempotency_key? | {order, charge, currency, balance?} | {order, duplicate: true} |
status | action, order | orders | {charge, start_count: null, status, remains: null, currency} | {"<order>": result} |
refill | action, order | {refill} |
Vai alla funzione
Questa guida ti è stata utile?
Feedback locale: non viene inviato all’assistenza. Per ricevere una risposta usa i contatti qui sotto.
Ti serve ancora una mano?
Apri l’assistenza nell’account per una richiesta specifica. Se non riesci ad accedere, scrivici via email.