API, claus i SDK

Al portal de desenvolupadors, crea una clau per a l’empresa i selecciona només els permisos que necessita la integració. Desa-la de manera segura i utilitza Test per assajar.

No posis el secret al codi del navegador ni el comparteixis en captures. L’API està inclosa als plans, però les operacions continuen subjectes a mòduls, permisos i capacitat.

401 apunta a l’autenticació de la petició. 403 indica que l’accés no està permès. Comprova clau, empresa, entorn i permisos.

422 requereix revisar els camps o la regla de negoci indicada a la resposta. 429 indica un límit de peticions. Respecta l’espera comunicada i redueix la freqüència en lloc de repetir en bucle.

Consulta primer si l’operació anterior ha acabat. Utilitza Idempotency-Key en les operacions compatibles i conserva la mateixa clau per reintentar la mateixa petició amb el mateix contingut.

No reutilitzis aquella clau amb dades diferents. Un conflicte d’idempotència exigeix revisar la petició. Els SDK i la documentació descriuen el contracte de cada operació.

Comprova que la clau pertanyi a la mateixa empresa i al mateix entorn que consultes a l’aplicació. Test i Live mantenen contextos diferents.

Revisa també l’identificador enviat i els permisos documentals. Donar més permisos no corregeix una referència d’una altra empresa ni converteix dades de prova en dades reals.