Glossari · C
Clau d'API
La credencial secreta amb què un programa s'identifica davant d'una API: qui la té pot llegir en nom teu, així que s'ha de guardar com una contrasenya.
Què és
Una clau d'API és una cadena llarga i aleatòria que un programa envia en cada petició, normalment a la capçalera «Authorization», perquè l'API sàpiga de qui és la petició, què pot llegir i quant li queda de la seva quota. A diferència d'una contrasenya, no l'escriu una persona: la genera el servei i la copia qui integra el programa.
Les bones pràctiques són les mateixes en qualsevol servei seriós. La clau es mostra una sola vegada, en crear-la, i el servei només en desa una empremta (un «hash») que no permet reconstruir-la. Cada clau porta només els permisos que necessita, perquè una filtració tingui el menor abast possible. Es pot revocar a l'instant, i aleshores deixa de funcionar encara que algú la conservi. I mai no viatja a l'adreça de la pàgina ni es desa al codi que es publica.
Si una clau es perd o se sospita que algú l'ha vista, el correcte no és buscar-la: es revoca i se'n crea una altra. Per això convé donar a cadascuna un nom que digui on es fa servir.
A la LCSP
- art. 63.1 LCSP: difusió exclusiva per Internet, accés lliure, formats oberts i cinc anys de disponibilitat
- art. 347.3 LCSP: serveis autonòmics propis i obligació de publicar convocatòries i resultats a la Plataforma
Cites comprovades al text consolidat de la Llei 9/2017 al BOE (en castellà) el 25 d’octubre del 2026. Les xifres que canvien porten la norma i la data; el plec de cada licitació preval sobre qualsevol resum.
Com el fa servir Adjudico.es
A Adjudico.es les claus es creen a El meu compte › API, amb els permisos read:companies, read:tenders i read:fits; només en desem l'empremta SHA-256 i el prefix, mai no les escrivim als registres i l'API no accepta crides des del navegador d'una altra web. Detall a API i exportacions.
Termes relacionats
- API (interfície de programació): Una porta perquè un programa llegeixi dades d'un altre sense passar per la pantalla: el teu CRM demana, per exemple, els contractes que vencen i rep una resposta estructurada.
- CSV (valors separats per comes): Un fitxer de text amb una taula a dins: una fila per línia i els camps separats per un caràcter fix, que qualsevol full de càlcul obre.
- PLACSP (Plataforma de Contractació del Sector Públic): Plataforma electrònica del Ministeri d'Hisenda que allotja els perfils de contractant del sector públic estatal i agrega les convocatòries i els resultats de totes les administracions.