Ids con prefijo
Un id de la API es un prefijo, un guión bajo y 32 caracteres hexadecimales: doc_0104f9ae5df240be8a3a57c1d2e3f4a5. El prefijo es presentación: es el mismo identificador que ves en la consola, con su tipo adelante. La ventaja se nota en los registros: un id suelto en un log no dice nada; uno con prefijo dice qué es.
Los prefijos
| Prefijo | Recurso |
|---|---|
cmp_ | company |
key_ | API key |
usr_ | console user |
cat_ | catalogue entry |
trd_ | third party |
cor_ | consent correction |
mrg_ | subject merge |
prs_ | rights process |
pub_ | document publication |
agr_ | agreement |
ent_ | consent entry |
evd_ | evidence |
frm_ | consent form |
tpl_ | consent template |
csr_ | consent request |
dsr_ | data subject request |
sub_ | data subject |
pa_ | processing activity |
snp_ | register snapshot |
doc_ | document |
prc_ | processor |
inc_ | incident |
ntf_ | incident notification |
dcs_ | incident decision |
dpa_ | impact assessment |
rsk_ | risk assessment |
tsk_ | task |
ppl_ | roster person |
tcn_ | training content |
tdf_ | training campaign |
ack_ | training acknowledgement |
rpt_ | report |
whk_ | webhook |
cnx_ | connector |
run_ | connector run |
prp_ | inventory proposal |
exp_ | export |
dlv_ | webhook delivery |
bnt_ | mass notice to data subjects |
pnt_ | public breach notice |
inq_ | DPO inquiry |
ais_ | AI system |
ctl_ | control |
cev_ | control evidence |
rrg_ | register risk |
dpr_ | DPIA risk |
Cuando el prefijo no calza
Si mandas un id de otro recurso, la petición no llega a la base: responde 400 validation_error nombrando lo que mandaste y lo que se esperaba.
GET /api/v1/documents/tsk_0104f9ae5df240be8a3a57c1d2e3f4a5
{
"type": "validation_error",
"title": "Validation error",
"status": 400,
"requestId": "req_…",
"errors": [{ "field": "id", "message": "Expected the id of a document (`doc_…`), but this is the id of a task." }]
}req_ está reservado: es el requestId de cada petición, no un recurso.