Retour au guide

API : services, prix, commandes, état et refill

Paramètres et réponses des actions publiées.

Dernière mise à jour:

Fonctionnement étape par étape

  1. services renvoie un tableau avec service, description, platform, min, max, rate, price_per_item, pricing_unit, refill, cancel et currency EUR. rate est une référence pour 1000, pas un devis universel.
  2. balance fournit le solde. add utilise service, link et quantity ; conservez order, charge et currency. Le moteur du site calcule le total et les minimums applicables.
  3. Utilisez une idempotency_key stable pour chaque achat et ses nouvelles tentatives : facultative, limitée à 120 caractères et liée à la clé API.
  4. status accepte order ou orders, jusqu’à 100 ID numériques séparés par virgules, uniquement pour vos commandes API. start_count et remains sont null.
  5. refill reçoit order et renvoie un identifiant si accepté. Aucune action de suivi refill ou d’annulation n’est publiée ; cancel dans le catalogue n’est pas un endpoint.

Attention

États API : Pending, In progress, Processing, Partial, Completed et Canceled. Ne déduisez pas les quantités restantes de null et ne présumez pas l’acceptation du refill.

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

Référence API publique

POST https://nexwa.store/api/v2
ActionParamètresRéponse
servicesactionArray<{service, name, category, platform, type, rate, price_per_item, pricing_unit, description, min, max, refill, cancel, currency}>
balanceaction{balance, currency}
addaction, service, link, quantity, idempotency_key?{order, charge, currency, balance?} | {order, duplicate: true}
statusaction, order | orders{charge, start_count: null, status, remains: null, currency} | {"<order>": result}
refillaction, order{refill}

Ouvrir la fonction

Clés APITarifs

Articles liés

Besoin d’aide ?

Ouvrez l’assistance du compte pour une demande précise. Sans accès, écrivez-nous par e-mail.

Ouvrir l’assistanceÉcrire par e-mail