# Vimine pour les développeurs

> Vimine is the membership platform for Italian associations (APS) and Third Sector organisations. For developers working for an association: Sign in with Vimine (OAuth 2.1 + PKCE), the member API, server integrations, card verification, the public profile and the enrolment form — with the JavaScript SDK `@vimine/sdk`, the OpenAPI 3.1 reference and these guides.

Rules for code assistants:

- The `client_secret` (`vms_…`) never goes into code that runs in a browser or an app: websites and apps are public clients, using authorization code + PKCE (S256) and a `state` compared on return.
- Members sign in only on Vimine's page (`https://app.vimine.network/authorize`), reached by a redirect: never a credentials form on your site, never in an iframe.
- The secret lives only on a server: `client_credentials` for the association's own systems; HTTP Basic directly only where the reference allows it, never from a browser.
- Start with a test client in the association's sandbox (synthetic members, active at once); a production client works after Vimine activates it.
- Use the SDK (`@vimine/sdk`, `@vimine/sdk/react`, `@vimine/sdk/server`) instead of rewriting the OAuth flow; tokens stay in `sessionStorage` (per tab) unless you choose otherwise knowingly.
- Check `aps.accepting_requests` before showing an enrolment form; retry a membership request (`POST /v1/me/membership`) with the same `Idempotency-Key`, never a new one.
- Errors are `application/problem+json` (RFC 9457) with a stable `code`: branch on the `code`, not the text, and quote the `request_id` when you report a problem.
- Ask only for the scopes you need: the member sees each one on the consent page.
- Never combine data from different associations: a member's `sub` differs from one association to the next, and the developer terms forbid correlating them.

## Commencer

- [Vue d’ensemble](https://developers.vimine.network/fr/start/overview.md): Ce que l’API Vimine offre à qui développe pour une association, et les notions à connaître avant de commencer.
- [Enregistrer un client](https://developers.vimine.network/fr/start/register-a-client.md): Comment un dirigeant enregistre une intégration depuis la console Développeurs, quel type choisir, ce qu’il faut enregistrer exactement.
- [Installer le SDK](https://developers.vimine.network/fr/start/install.md): Le paquet @vimine/sdk, ses trois points d’entrée, les prérequis.

## Guides

- [Se connecter avec Vimine](https://developers.vimine.network/fr/guides/sign-in.md): Le flux OAuth 2.1 + PKCE du clic au callback, la session, les appels à l’API et la déconnexion, avec et sans le SDK.
- [Sandbox et clients de test](https://developers.vimine.network/fr/guides/sandbox.md): L’association jumelle avec des membres synthétiques dans tous les états, les clients de test et la réinitialisation.
- [Intégrations serveur](https://developers.vimine.network/fr/guides/server.md): Les clients confidentiels pour les systèmes de l’association, client_credentials, l’état des cartes, la rotation du secret.
- [Admission et activation](https://developers.vimine.network/fr/guides/admission.md): Comment une association admet ses membres, quand la cotisation est payée, quand la carte fait foi à l’entrée — et que dire aux personnes qui adhèrent depuis votre site.
- [Membres sans code fiscal](https://developers.vimine.network/fr/guides/members-without-cf.md): Une personne est identifiée par un code fiscal ou par sa date, son lieu et son pays de naissance. Quoi envoyer pour les personnes nées à l’étranger, comment confirmer un code en désaccord, quoi afficher à l’entrée.
- [Langues](https://developers.vimine.network/fr/guides/languages.md): Demander le contenu d’une association dans une autre langue avec ?locale=, savoir grâce à locale et locales ce qui a été servi, dire dans quelle langue écrire à une personne. Jamais de traduction automatique.
- [Intégration et vérification des cartes](https://developers.vimine.network/fr/guides/embed-and-verify.md): Le formulaire d’adhésion sur votre site, le profil public de l’association et la vérification des cartes en ligne et hors ligne.
- [Événements et inscriptions](https://developers.vimine.network/fr/guides/events.md): Publiez les événements de l’association sur votre site, laissez les membres s’inscrire (et les invités, pour les événements publics), contrôlez les entrées avec le même scanner que pour les cartes.
- [Plugin WordPress](https://developers.vimine.network/fr/guides/wordpress.md): Se connecter avec Vimine, la carte du membre et l’adhésion sur le site WordPress de l’association — sans code.
- [Autorisations, erreurs et limites](https://developers.vimine.network/fr/guides/scopes-and-errors.md): Le tableau des scopes, le format des erreurs (RFC 9457) avec des codes stables, les limites de débit.

## SDK

- [Vimine (navigateur)](https://developers.vimine.network/fr/sdk/browser.md): Référence de la classe Vimine de @vimine/sdk — connexion, session, appels à l’API, stockage.
- [React](https://developers.vimine.network/fr/sdk/react.md): VimineProvider, useVimine et SignInButton de @vimine/sdk/react.
- [Éléments (low-code)](https://developers.vimine.network/fr/sdk/elements.md): Les éléments personnalisés <vimine-sign-in>, <vimine-card> et <vimine-enroll> — une balise HTML, aucun framework.
- [VimineServer](https://developers.vimine.network/fr/sdk/server.md): Référence de la classe VimineServer de @vimine/sdk/server pour les clients confidentiels.
- [API publique](https://developers.vimine.network/fr/sdk/public.md): publicApi() — vérification des cartes, profil public d’une association, code fiscal, clés publiques. Sans identifiants.
- [Erreurs](https://developers.vimine.network/fr/sdk/errors.md): VimineError — un seul type d’erreur pour tout ce que l’API et le SDK peuvent refuser, avec un code stable.
- [Types](https://developers.vimine.network/fr/sdk/types.md): Les types TypeScript du SDK — les mêmes structures JSON que l’API v1, noms de champs inchangés.

## API HTTP

- [OpenAPI 3.1 document](https://api.vimine.network/v1/openapi.json): The whole API: paths, scopes, schemas and errors.
- [OAuth discovery (RFC 8414)](https://api.vimine.network/.well-known/oauth-authorization-server): Authorization, token and revocation endpoints; supported PKCE methods and scopes.
- [Interactive console](https://developers.vimine.network/fr/api/console/): Try the calls against the sandbox with a test client.

## Optional

- [Everything in one file](https://developers.vimine.network/fr/llms-full.txt): Every page in this language in a single Markdown file.
- [@vimine/sdk on npm](https://www.npmjs.com/package/@vimine/sdk): The SDK: browser, React and server.
- [Italiano](https://developers.vimine.network/llms.txt): The same pages in Italiano.
- [English](https://developers.vimine.network/en/llms.txt): The same pages in English.
- [Español](https://developers.vimine.network/es/llms.txt): The same pages in Español.
- [Deutsch](https://developers.vimine.network/de/llms.txt): The same pages in Deutsch.
- [Português (Brasil)](https://developers.vimine.network/pt/llms.txt): The same pages in Português (Brasil).
- [简体中文](https://developers.vimine.network/zh-hans/llms.txt): The same pages in 简体中文.
- [繁體中文](https://developers.vimine.network/zh-hant/llms.txt): The same pages in 繁體中文.