API Produits
Obtenir les Produits
Récupérez la liste des produits numériques disponibles dans le catalogue SofizPay, avec filtrage optionnel par nom
Point de Terminaison API
GET
https://sofizpay.com/services/get_products/Ce point retourne les produits disponibles filtrés par disponibilité, en renvoyant uniquement des informations simplifiées (nom et prix)
Ce point nécessite une clé secrète Stellar valide pour l'authentification via le champ encrypted_sk
Paramètres de la Requête
Content-Type: application/json
| Paramètre | Type | Requis | Description |
|---|---|---|---|
encrypted_sk | string | Oui | Clé secrète Stellar chiffrée ou en clair. Peut être une clé en clair commençant par "S" (56 caractères) ou une clé chiffrée RSA encodée en base64 |
search | string | Non | Terme de recherche optionnel pour filtrer les produits par nom |
Exemple de Requête
Exemple avec terme de recherche
bash
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ...",
"search": "PUBG"
}'Exemple sans terme de recherche (tous les produits)
bash
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ..."
}'Réponse de Succès (200)
Retourne une liste de produits disponibles avec leurs noms et prix en DZT
json
1{
2 "status": "success",
3 "count": 8,
4 "products": [
5 {
6 "name": "PUBG 1320 UC",
7 "price": "4743.24"
8 },
9 {
10 "name": "PUBG 1800 UC",
11 "price": "5929.05"
12 },
13 {
14 "name": "PUBG 325 UC",
15 "price": "1185.81"
16 }
17 ]
18}Réponses d'Erreur
400 - JSON invalide
json
{
"status": "error",
"message": "Invalid JSON"
}400 - encrypted_sk est requis
json
{
"status": "error",
"message": "encrypted_sk is required"
}400 - Clé secrète invalide
json
{
"status": "error",
"message": "Invalid secret key"
}400 - Format de clé secrète invalide
json
{
"status": "error",
"message": "Invalid secret key format"
}500 - Erreur API externe
json
{
"status": "error",
"message": "Error fetching products: [error details]"
}Champs de la Réponse
| Champ | Type | Description |
|---|---|---|
status | string | Statut de la réponse : "success" ou "error" |
count | integer | Nombre total de produits disponibles retournés |
products | array | Tableau d'objets produits |
products[].name | string | Nom du produit |
products[].price | string | Prix du produit en DZT |
Fonctionnalités
Authentification : Valide les clés secrètes Stellar
Support du Chiffrement : Gère les clés en clair et chiffrées RSA
Filtrage de Recherche : Paramètre de recherche optionnel pour filtrer les produits
Filtre de Disponibilité : Retourne uniquement les produits marqués comme disponibles
Réponse Simplifiée : Retourne uniquement les informations essentielles (nom et prix)
Intégration API Externe : Récupère les données depuis sofizpay.dz
- Tous les produits disponibles sont retournés si aucun terme de recherche n'est fourni
- Les prix sont retournés sous forme de chaînes pour éviter les problèmes de précision des nombres flottants
- Seuls les produits avec is_available: true sont inclus dans la réponse
- Le point utilise l'exemption CSRF pour faciliter l'intégration des clients