Glossari · A
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.
Què és
Una API (de l'anglès «application programming interface») és un contracte entre dos programes: un pregunta amb una adreça web i uns paràmetres fixos, i l'altre respon sempre amb la mateixa estructura, normalment en JSON. Serveix perquè les dades arribin allà on s'hi treballa (un CRM, un full de càlcul que s'actualitza sol, un quadre de comandament) sense copiar i enganxar des d'una pàgina.
En la contractació pública la informació d'origen ja és oberta: la llei obliga a difondre el perfil de contractant per Internet, amb accés lliure i en formats oberts i reutilitzables, i a centralitzar-lo a la Plataforma de Contractació del Sector Públic. Una API no hi afegeix dades noves; ordena les que existeixen i les lliura ja creuades: què ha guanyat una empresa, quan venç cada contracte, quines licitacions obertes s'hi assemblen.
El que distingeix una bona API és l'estabilitat: els noms dels camps no canvien sense avís, les llistes es recorren per pàgines amb un cursor i els errors diuen què ha passat amb un codi fix. Per això es descriu en un document formal, normalment en el format OpenAPI, que qualsevol eina pot llegir.
A la LCSP
- art. 63.1 LCSP: difusió exclusiva per Internet, accés lliure, formats oberts i cinc anys de disponibilitat
- art. 347.1 i 347.2 LCSP: la plataforma i l'obligació d'allotjar-hi els perfils del sector públic estatal
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
L'API de lectura d'Adjudico.es (plans Consultora i Grup) retorna en JSON el resum d'una empresa, els seus contractes i venciments, les licitacions obertes per CPV i zona, els anuncis previs, els organismes i els encaixos amb un perfil desat, cada element amb el seu enllaç oficial i la seva etiqueta. Amb la mateixa clau es connecta a Claude per MCP. Rutes, límits i exemples amb curl a API i exportacions.
Termes relacionats
- 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.
- 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.
- Perfil de contractant: Espai a Internet on cada òrgan de contractació publica obligatòriament la seva activitat contractual: anuncis, plecs, actes, adjudicacions, formalitzacions i contractes menors.