# API Kapacity

> L'API publique de Kapacity : contacts, tables du CRM, rendez-vous, formulaires, contrats,
> ventes, équipe et journal d'activité. Authentification par clé, une clé porte sur UN espace.

## L'essentiel

- Adresse de base : `https://kapacity.app/api/v1/w/{workspace_id}`
- En-tête : `Authorization: Bearer kap_live_…`
- Premier appel à faire : `GET /me` (il confirme la clé, l'espace et le quota restant).
- Deux portées de clé : « lecture » et « lecture_ecriture ». Une clé de lecture reçoit 403 sur toute écriture.
- Pagination par curseur, jamais par numéro de page : reprendre `curseur` de la réponse précédente.

## Documentation complète

- [Référence complète (markdown)](https://kapacity.app/llms-full.txt) : tout, à coller dans une conversation.
- [Contrat OpenAPI](https://kapacity.app/openapi.json)

## Pas à pas (dans la référence complète)

- Envoyer un contrat à un contact : `GET /contract-templates`, puis `GET /tables/{id}/records`, puis `POST /contracts`.
- Être prévenu quand un contrat est signé : `POST /webhooks`, puis webhook `contrat.signe`.

## Votre espace

- `GET /me` : Votre espace, votre plan et l'état de votre quota.

## CRM : tables et lignes

- `GET /tables` : Les tables du CRM de cet espace, et la base de chacune.
- `GET /tables/{id}` : Les colonnes d'une table : identifiant, nom, type, choix possibles.
- `GET /tables/{id}/records` : Les lignes d'une table, page par page.
- `POST /tables/{id}/records` : Crée une ligne dans une table.
- `POST /tables/{id}/records/bulk` : Créer jusqu'à 100 lignes en un seul appel.
- `GET /records/{id}` : Une ligne et les colonnes de sa table.
- `PATCH /records/{id}` : Modifie les valeurs d'une ligne.
- `DELETE /records/{id}` : Supprime une ligne. Définitif.

## Rendez-vous

- `GET /event-types` : Les types de rendez-vous, avec leur lien public de réservation.
- `GET /bookings` : Les rendez-vous, du plus ancien au plus récent.

## Formulaires

- `GET /forms` : Les formulaires de qualification et leur lien public.
- `GET /forms/{id}/responses` : Les réponses d'un formulaire, avec leur score.

## Contrats

- `GET /contracts` : Les contrats, leur statut et leurs dates clés.
- `GET /contracts/{id}` : Un contrat, son corps et sa piste d'audit.
- `GET /contract-templates` : Les modèles de contrat, pour savoir lequel envoyer.
- `POST /contracts` : Envoie un contrat à un contact, au montant que vous indiquez, et rend son lien de signature.

## Ventes et paiements

- `GET /products` : Le catalogue de produits, avec prix et échéanciers.
- `GET /payments` : Les paiements reçus, tels que le fournisseur les a constatés.

## Équipe

- `GET /members` : Les membres de l'espace et leur rôle.

## Journal d'activité

- `GET /activity` : Le journal d'activité de l'espace : qui a fait quoi, quand.

## Webhooks

- `GET /webhooks` : Vos abonnements aux événements, et la liste des événements possibles.
- `POST /webhooks` : S'abonner à un ou plusieurs événements.
- `PATCH /webhooks/{id}` : Renommer un abonnement, changer son adresse, ses événements ou son en-tête, ou le réactiver.
- `DELETE /webhooks/{id}` : Supprimer un abonnement, et son journal d'envois.
- `POST /webhooks/{id}/test` : Envoyer un événement d'exemple, pour brancher sans attendre un vrai.
- `GET /webhooks/{id}/deliveries` : Le journal des envois : ce qui est parti, ce qui a été refusé, et pourquoi.
- `POST /webhooks/{id}/deliveries/{envoi}/replay` : Renvoyer un événement déjà émis, par exemple après une panne de votre serveur.