Documentation API

L'API Qyvn.io est une API REST JSON exposée sur https://api.qyvn.io/v1.

Conventions

Méthodes HTTP standard (GET, POST, PATCH, DELETE)
Réponses JSON avec Content-Type: application/json
Dates ISO 8601 UTC
Montants en centimes, entier

Ressources principales

Ressource	Endpoint
Entités	`/v1/entities`
Transactions	`/v1/transactions`
Factures	`/v1/invoices`
Projets	`/v1/projects`
Rapports	`/v1/reports`
Webhooks	`/v1/webhooks`

Exemple

curl https://api.qyvn.io/v1/transactions \
  -H "Authorization: Bearer $QYVN_API_KEY" \
  -H "Qyvn-Entity: ent_9f2a"

Réponse :

{
  "data": [
    {
      "id": "txn_01HZ...",
      "amount": 129900,
      "currency": "EUR",
      "date": "2025-11-04",
      "counterparty": "Acme SAS",
      "status": "reconciled"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ"
}

Pagination

Cursor-based via ?cursor=...&limit=50. Limite max : 200.

Erreurs

{
  "error": {
    "code": "invalid_request",
    "message": "Missing field: amount",
    "field": "amount",
    "request_id": "req_01HZ..."
  }
}