API bankpdf

1. Obtenir une clé API

Crée une clé depuis ta page Mon compte. La clé (bpk_live_…) n'est affichée qu'une seule fois — conserve-la côté serveur, jamais dans du code client.

2. Endpoint

POST https://www.bankpdfapp.com/api/v1/convert

• Auth : header Authorization: Bearer bpk_live_…
• Corps : multipart/form-data
• • file — le PDF ou l'image (≤ 20 Mo, requis)
• • documentType — bank-statement (défaut) · invoice · receipt · payslip
• Query : ?format=json (défaut) ou csv
• Limite : 60 requêtes / minute / clé

3. Exemple — relevé bancaire

curl -X POST "https://www.bankpdfapp.com/api/v1/convert" \
  -H "Authorization: Bearer bpk_live_xxx" \
  -F "file=@releve-bnp.pdf" \
  -F "documentType=bank-statement"

Réponse :

{
  "documentType": "bank-statement",
  "filename": "releve-bnp.pdf",
  "bank": "BNP Paribas",
  "pages": 3,
  "transactions": [
    { "date": "2024-04-01", "description": "EDF ENERGIE",
      "debit": 85.50, "credit": null, "amount": -85.50, "balance": 2364.50 }
  ]
}

4. Exemple — facture

curl -X POST "https://www.bankpdfapp.com/api/v1/convert" \
  -H "Authorization: Bearer bpk_live_xxx" \
  -F "file=@facture.pdf" \
  -F "documentType=invoice"

{
  "documentType": "invoice",
  "header": {
    "invoiceNumber": "F-2024-018", "issueDate": "2024-04-02",
    "sellerName": "ACME SAS", "currency": "EUR",
    "subtotal": 1000, "taxAmount": 200, "total": 1200
  },
  "rows": [
    { "description": "Prestation conseil", "quantity": 10,
      "unitPrice": 100, "amount": 1000 }
  ]
}

5. Erreurs

• 401 — clé manquante, invalide ou révoquée
• 413 — fichier > 20 Mo · 415 — type non supporté
• 429 — limite de débit dépassée (voir Retry-After)
• 502 — échec d'extraction