--- title: "API, les claus del desenvolupador" description: "Crea i gestiona claus eAPI per integrar els fluxos de cerca, disponibilitat i reserva de LeyApp al teu propi producte." source: https://staging.leyapp.es/ca/help/developer-api-keys locale: ca updated: 2026-07-25T12:00:00Z --- # API, les claus del desenvolupador Crea i gestiona claus eAPI per integrar els fluxos de cerca, disponibilitat i reserva de LeyApp al teu propi producte. _Font: https://staging.leyapp.es/ca/help/developer-api-keys — Darrera actualització: 25 de juliol del 2026_ > **Nota** > Aquest article tracta sobre les **claus d'aplicació (API)** (leyk_...) per a desenvolupadors que invoquin les API REST de LeyApp des del seu propi programari. Si només voleu connectar un assistent d'IA com Claude o ChatGPT al vostre compte de LeyApp, no necessiteu una clau d'aplicació — consulteu «Connect your AI assistant to LeyApp» en lloc d'això. ## Què és el desenvolupador API? LeyApp exposa un API REST públic sota /api/v1 que et permet cercar advocats, consultar la disponibilitat i iniciar reserves des del teu propi lloc web, aplicació o eina interna. L'accés de lectura bàsic funciona sense cap credencial, però una clau API augmenta els límits de velocitat, desbloqueja punts finals addicionals i et proporciona un tauler de control amb les teves claus i l'ús. Qualsevol compte d'LeyApp pot crear claus API — no cal cap tipus de compte especial. Les reserves iniciades a través del API mai no es carreguen automàticament: el client sempre confirma i paga a leyapp.es, de manera que la vostra integració mai no gestiona diners ni detalls de la targeta. ## Crear una clau API Les claus es gestionen des del teu tauler de control: 1. Obre el tauler de control → Desenvolupador des de la barra lateral. 2. Feu clic a "Crea clau" i doneu-li un nom descriptiu, p. ex. "Giny del lloc web (producció)". 3. Tria el tipus de clau: Live per a sol·licituds reals, o Test per a experimentar amb seguretat. 4. Copieu la clau immediatament i deseu-la en un lloc segur, com ara un gestor de contrasenyes o l'emmagatzematge secret del vostre proveïdor d'allotjament. > **Avís** > La clau completa es mostra exactament una vegada, just després de la creació.LeyAppnomés emmagatzema una empremta d'aquesta, de manera que mai més es podrà mostrar. Si perds una clau, revoca-la i crea'n una de nova. ## Claus de prova vs claus en viu Les claus de prova (leyk_test_...) es comporten exactament com les claus en viu — mateixos punts finals, mateixes respostes, mateixa validació — amb una diferència crucial: no passa res real. Una sol·licitud de reserva de prova es comprova completament amb la disponibilitat real, però no es crea cap intenció de reserva ni es notifica cap advocat. Les claus en viu (leyk_...) creen intencions de reserva reals. Quan un client segueix l'enllaç de confirmació d'una intenció en viu, se l'envia al flux normal de pagament i confirmació de LeyApp. > **Consell** > Construïu la vostra integració amb una clau de prova primer. Quan tot funcioni, substituïu-la per una clau en viu — no calen canvis de codi més enllà de la pròpia clau. ## Claus del despatx Si formes part d'un despatx d'advocats a LeyApp, a Dashboard → Developer es mostren dues llistes separades: les teves claus personals i les claus del teu despatx. Una clau de despatx pertany al despatx, no a la persona que la va crear, de manera que continua funcionant quan aquesta persona canvia de rol o marxa. Els propietaris i administradors poden gestionar les claus de l'empresa immediatament. Tots els altres membres comencen sense cap accés i se'ls ha d'atorgar una capacitat a la vegada des de la llista de membres de l'empresa: - Vista — mostra les claus de l'empresa, els seus prefixos i quan es va utilitzar cadascuna per última vegada. El secret en si mai no es torna a mostrar a ningú, ni tan sols als propietaris. - Gestionar — crear, revocar, suspendre i restringir les claus de l'empresa. - Webhooks — gestiona els punts finals de webhooks de l'empresa. S'apliquen dos controls addicionals a les claus de l'empresa. Pots restringir una clau a una llista d'adreces IP o de rangs, de manera que fins i tot si la clau es filtra, se li negarà l'accés des de qualsevol altre lloc. I pots suspendre una clau per aturar-la sense destruir-la, cosa que és útil mentre investigues alguna cosa estranya. > **Nota** > Quan un membre que ha creat les claus de l'empresa marxa, aquestes claus continuen funcionant i s'envien per correu electrònic als propietaris i administradors de l'empresa. Això és deliberat: revocar-les en el moment de la sortida faria caure qualsevol servei que l'empresa tingui en marxa amb elles. En lloc d'això, reemplaceu-les: creeu una de nova, traslladeu la integració i després revogueu l'antiga. ## Utilitzant la teva clau Envia la clau a l'encapçalament Authorization de cada petició: "Authorization: Bearer leyk_...". Les peticions sense clau encara funcionen per a punts finals públics, però amb límits de velocitat anònims més baixos. Cada resposta inclou un capçalera X-Request-Id. Si alguna cosa es comporta de manera inesperada, inclou aquest ID quan contactis amb el servei d'assistència — ens permet trobar la teva sol·licitud exacta en segons. ## Límits de velocitat Les noves clau comencen en el nivell gratuït: 60 sol·licituds per minut i 5.000 al dia. Cada resposta t'indica la teva situació mitjançant els encapçalaments X-RateLimit-Limit i X-RateLimit-Remaining; si superes el límit, reps una resposta 429 amb un encapçalament Retry-After que t'indica quan tornar-ho a provar. Hi ha nivells superiors per a socis que són atorgats per l'equip d'LeyApp — poseu-vos en contacte amb nosaltres a través del formulari de suport si la vostra integració necessita més capacitat. ## Com guardar les claus de manera segura Una clau d'API és una contrasenya per a la teva integració. Tracta-la com a tal: - No posis mai una clau en codi client, aplicacions mòbils o repositoris públics — qualsevol que la pugui llegir pot gastar el teu límit de velocitat i actuar dins dels àmbits de la clau. - Utilitza una clau separada per a cada integració o entorn, de manera que puguis revocar-ne una sense afectar les altres. - Revoca les claus que ja no utilitzes. La revocació és immediata: les sol·licituds amb una clau revocada fallen en la següent crida. - Si una clau pot haver-se filtrat, revoca-la immediatament a Dashboard → Developer i crea-ne una de substitució. La rotació és sense temps d'inactivitat: crea primer la nova clau, implementa-la i després revoca l'antiga. ## Resolució de problemes Rebo un 401 "Clau API invàlida". Comproveu que l'encapçalament sigui exactament "Authorization: Bearer leyk_..." sense espais addicionals i que la clau no hagi estat revocada. Tingueu en compte que els tokens MCP (ley_...) de Configuració → API Tokens són una credencial diferent i no són vàlids a la interfície REST API. M'apareix un 429 "Rate limit exceeded". Has assolit la finestra per minut o per dia del teu nivell. Honra l'encapçalament Retry-After i torna a provar amb retard exponencial. Si assoleixes regularment el límit diari, pregunta'ns per un nivell superior. Les meves reserves de prova mai no apareixen enlloc. Això és així per disseny: les claus de prova validen tot però no creen res. Canvia a una clau en viu per crear intencions de reserva reals. No puc aixecar la suspensió d'una de les claus de la meva empresa. Una clau pot ser suspesa per la vostra empresa o per LeyApp. Les suspensions pròpies de la vostra empresa poden ser aixecades per qualsevol propietari o administrador. Una suspensió imposada per LeyApp — per exemple mentre investiguem trànsit inusual — només pot ser aixecada per nosaltres, així que contacteu amb support@leyapp.es. > **Nota** > La referència completa de les API, els exemples de sol·licituds i respostes i les guies d'integració estan disponibles al portal de desenvolupadors a leyapp.es/developers.