Convenciones de nombres en respuestas API: Guía completa
4 min de lectura
La nomenclatura consistente en respuestas API reduce la confusión y hace tu API intuitiva para los consumidores.
Patrones comunes
| Tipo de campo | Patrón | Ejemplos |
|---|---|---|
| ID | recurso + Id/id | userId, orderId |
| Timestamp | verbo + At/at | createdAt, updatedAt |
| Boolean | is/has + adjetivo | isActive, hasVerified |
| Conteo | sustantivo + Count | itemCount, pageCount |
| URL | sustantivo + Url | avatarUrl, websiteUrl |
Paginación
{ "data": [...], "pagination": { "page": 1, "pageSize": 20, "totalCount": 100, "totalPages": 5 } }Convertir
Usa el conversor de claves JSON a camelCase o snake_case.