Présentation de la référence

Adresse de base, authentification, conventions et liste de tous les endpoints.

Adresse de base :

https://api.pulse-sell.com/v1

Toutes les requêtes envoient Authorization: Bearer psk_… et, pour un corps, Content-Type: application/json. Voir Authentification.

Réponses

Enveloppe data, montants, dates.

Pagination

Curseurs, per_page jusqu’à 100.

Erreurs

Codes stables à traiter dans votre code.

Tous les endpoints

Ressource	Endpoints	Permission
Compte	GET /me	aucune
Boutique	GET /store	store.read
Produits	GET /products, GET /products/{id}, POST /products, PATCH /products/{id}, POST /products/{id}/publish, POST /products/{id}/unpublish, POST /products/{id}/archive, DELETE /products/{id}	products.read / products.write
Checkout	POST /checkout	checkout.write
Ventes	GET /sales, GET /sales/{id}, POST /sales/{id}/fulfill, POST /sales/{id}/cancel	sales.read / sales.write
Clients	GET /customers, GET /customers/{id}	customers.read
Codes promo	GET /discounts, GET /discounts/{id}, POST /discounts, PATCH /discounts/{id}, DELETE /discounts/{id}	discounts.read / discounts.write
Licences	POST /licenses/validate, GET /licenses, GET /licenses/{id}, GET /licenses/{id}/activations, POST /licenses/{id}/activate, POST /licenses/{id}/deactivate, POST /licenses/{id}/revoke	licenses.read / licenses.write
Affiliés	GET /affiliates, GET /affiliates/{id}, GET /affiliates/{id}/commissions	affiliates.read
Pulses	GET /pulses, GET /pulses/{id}, POST /pulses, PATCH /pulses/{id}, DELETE /pulses/{id}, POST /pulses/{id}/test, POST /pulses/{id}/rotate-secret, GET /pulses/{id}/deliveries	pulses.read / pulses.write

Spécification OpenAPI

L’API publie sa propre spécification OpenAPI 3.1, générée depuis le code qui sert les requêtes : elle ne peut pas diverger de la réalité. Elle inclut les permissions de chaque endpoint, des exemples cURL, Node.js et Python, et les 12 événements Pulses.

curl https://api.pulse-sell.com/v1/openapi.json

Importez-la dans Postman, Insomnia ou un générateur de client pour obtenir un SDK dans votre langage. Elle est publique : elle ne contient aucune donnée de compte.

Ce que l’API ne fait pas, volontairement

• Aucun remboursement : mouvement d’argent, il reste dans le tableau de bord.
• Aucune publication implicite : un produit n’est jamais publié par un simple POST ou PATCH.
• Aucune livraison sans paiement : fulfill refuse une commande non encaissée.
• Aucune donnée de carte : le paiement se fait sur la page hébergée.