Agent API Fidelioo

curl -X GET https://fidelioo.co/api/agent/health \
  -H "X-Agent-Key: fid_agent_sk_prod_a8b3c9d2e1f4g5h6i7j8k9l0m1n2o3p4"

{
  "status": "ok",
  "timestamp": "2026-03-27T09:30:00Z",
  "version": "1.0.0",
  "agent": {
    "key_id": "key_48291",
    "name": "Caisse principale - POS",
    "partner": "Boulangerie Central",
    "type": "read_write",
    "scopes": ["members:read", "points:write", "stamps:write"],
    "ip_restriction": null
  }
}

{
  "status": "ok",
  "timestamp": "2026-03-27T09:30:00Z",
  "version": "1.0.0",
  "services": {
    "database": "ok",
    "cache": "ok",
    "sms": "ok"
  }
}

{
  "name": "Caisse principale - POS",
  "type": "read_write",
  "scopes": ["members:read", "points:write", "stamps:write"],
  "allowed_ips": ["196.192.168.1", "196.192.168.2"]
}

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "add_loyalty_points",
        "description": "Ajoute des points de fidélité à un membre en fonction du montant d'un achat",
        "parameters": {
          "type": "object",
          "properties": {
            "member_id": {
              "type": "integer",
              "description": "Identifiant unique du membre"
            },
            "card_id": {
              "type": "integer",
              "description": "Identifiant de la carte de fidélité"
            },
            "amount": {
              "type": "number",
              "description": "Montant de l'achat en XOF"
            },
            "note": {
              "type": "string",
              "description": "Note optionnelle pour la transaction"
            }
          },
          "required": ["member_id", "card_id", "amount"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "validate_stamp",
        "description": "Valide un tampon pour un membre dans un programme tampon",
        "parameters": {
          "type": "object",
          "properties": {
            "member_id": {
              "type": "integer",
              "description": "Identifiant unique du membre"
            },
            "stamp_card_id": {
              "type": "integer",
              "description": "Identifiant du programme tampon"
            }
          },
          "required": ["member_id", "stamp_card_id"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "get_member_by_phone",
        "description": "Recherche un membre par son numéro de téléphone et retourne son profil avec ses cartes",
        "parameters": {
          "type": "object",
          "properties": {
            "phone": {
              "type": "string",
              "description": "Numéro de téléphone au format international (ex: +22961000000)"
            }
          },
          "required": ["phone"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "redeem_reward",
        "description": "Traite l'échange d'une récompense par un membre",
        "parameters": {
          "type": "object",
          "properties": {
            "redemption_code": {
              "type": "string",
              "description": "Code d'échange généré par le membre"
            },
            "member_pin": {
              "type": "string",
              "description": "PIN à 4 chiffres du membre pour confirmation"
            }
          },
          "required": ["redemption_code", "member_pin"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "validate_coupon",
        "description": "Vérifie la validité d'un bon de réduction et l'applique à une transaction",
        "parameters": {
          "type": "object",
          "properties": {
            "coupon_code": {
              "type": "string",
              "description": "Code du bon de réduction"
            },
            "member_id": {
              "type": "integer",
              "description": "Identifiant du membre qui utilise le bon"
            },
            "purchase_amount": {
              "type": "number",
              "description": "Montant de l'achat en XOF avant réduction"
            }
          },
          "required": ["coupon_code", "purchase_amount"]
        }
      }
    }
  ]
}

import requests
from openai import OpenAI

# Récupérer les outils Fidelioo
fidelioo_tools = requests.get(
    "https://fidelioo.co/api/agent/v1/tools",
    params={"format": "openai"},
    headers={"X-Agent-Key": "fid_agent_sk_prod_xxx"}
).json()["tools"]

# Initialiser le client OpenAI
client = OpenAI()

# Appel au LLM avec les outils Fidelioo disponibles
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "Tu es un assistant de caisse pour la Boulangerie Central."},
        {"role": "user", "content": "Le client +22961000001 vient d'acheter pour 3500 FCFA."}
    ],
    tools=fidelioo_tools,
    tool_choice="auto"
)

curl -X POST https://fidelioo.co/api/agent/v1/partner/points/add \
  -H "X-Agent-Key: fid_agent_sk_prod_a8b3c9d2e1f4g5h6" \
  -H "X-Agent-Trace-Id: req_7f3a9b2c-1d4e-5f6a-7b8c-9d0e1f2a3b4c" \
  -H "X-Agent-Source: POS-CAISSE-1" \
  -H "Content-Type: application/json" \
  -d '{
    "member_id": 123,
    "card_id": 5,
    "amount": 7500,
    "note": "Achat caisse #4892 - 27/03/2026"
  }'

{
  "success": true,
  "data": {
    "transaction_id": "txn_48291abc",
    "member_id": 123,
    "card_id": 5,
    "amount_spent": 7500,
    "points_earned": 15,
    "points_balance_before": 127,
    "points_balance_after": 142,
    "level": "Or",
    "multiplier_applied": 2,
    "timestamp": "2026-03-27T09:35:12Z"
  },
  "audit": {
    "trace_id": "req_7f3a9b2c-1d4e-5f6a-7b8c-9d0e1f2a3b4c",
    "agent_key_id": "key_48291",
    "source": "POS-CAISSE-1"
  }
}

curl -X POST https://fidelioo.co/api/agent/v1/staff/stamps/scan \
  -H "X-Agent-Key: fid_agent_sk_prod_a8b3c9d2e1f4g5h6" \
  -H "X-Agent-Trace-Id: req_unique_uuid_here" \
  -H "Content-Type: application/json" \
  -d '{
    "qr_token": "QR_M123_STAMP_1711530912_abc123",
    "staff_id": 7,
    "stamp_card_id": 3
  }'

{
  "success": true,
  "data": {
    "stamp_transaction_id": "stmp_91827abc",
    "member": {
      "id": 123,
      "name": "Kouassi Attiogbe",
      "phone": "+22961000001"
    },
    "stamp_card": {
      "id": 3,
      "name": "10ème café offert",
      "stamps_before": 6,
      "stamps_after": 7,
      "stamps_required": 10,
      "progress_percent": 70
    },
    "reward_unlocked": false,
    "timestamp": "2026-03-27T10:15:44Z"
  }
}

{
  "id": "audit_1a2b3c4d5e",
  "timestamp": "2026-03-27T10:15:44Z",
  "agent_key": {
    "id": "key_48291",
    "name": "Caisse principale - POS"
  },
  "partner_id": 42,
  "action": "points.add",
  "resource_type": "member",
  "resource_id": 123,
  "source_ip": "196.192.168.1",
  "trace_id": "req_7f3a9b2c-1d4e-5f6a-7b8c-9d0e1f2a3b4c",
  "source_label": "POS-CAISSE-1",
  "request_body": {
    "member_id": 123,
    "card_id": 5,
    "amount": 7500
  },
  "response_status": 200,
  "result": "success",
  "duration_ms": 48
}