Sol·licitar accés a l'API
Per connectar el teu sistema amb l'API DeCA, contacta amb el suport de SERTEC PESAGE i sol·licita l'alta de la integració.
Dades per a l'alta
Indica l'empresa que utilitzarà el servici, el nom de la integració i, si vols restringir l'accés, les IP públiques de eixida dels servidors. Inclou totes les adreces utilitzades amb proxy, NAT o diverses màquines.
Suport configura la integració i lliura un token d'accés segur pel canal acordat. Cada integració té la seua credencial. Una llista d'IP buida permet accés des de qualsevol IP. Sol·licita l'actualització abans d'utilitzar una IP de eixida que haja canviat.
Primers passos
- Sol·licita el token i, si escau, l'autorització de les IP al suport de SERTEC PESAGE.
- Desa el token a la configuració segura del servidor.
- Envia
Authorization: Bearer YOUR_API_TOKENdes d'una IP autoritzada si hi ha restriccions.
Els tokens sk_test_ utilitzen desenvolupament i els sk_live_ producció. Comparteixen les rutes, amb documents i referències independents.
L'idioma dels documents de l'organització determina l'idioma dels PDF nous. Canviar-lo no modifica els PDF emmagatzemats. L'idioma de la documentació, els noms dels camps JSON i els missatges d'error de l'API en anglès són independents. document_locale registra l'idioma utilitzat al resultat.
Consulta Credencials i seguretat per configurar la connexió. La Referència de l'API conté operacions, paràmetres i exemples. Descarrega el contracte com a OpenAPI JSON o OpenAPI YAML.
Compte i arxiu
El codi de recuperació pertany al compte del portal i no substitueix el token de l'API. Per crear el compte cal configurar una passkey, imprimir o descarregar el codi i tornar-lo a introduir abans de completar l'alta.
Els PDF es conserven un any i les dades estructurades xifrades quatre anys, des de l'emissió o la data de transport si és posterior. Després de retirar el PDF, una persona autoritzada pot generar una còpia privada a partir de les dades conservades. Consulta Credencials i seguretat per conèixer els límits d'accés i recuperació.
Provar sense donar d’alta una integració
La demostració pública permet obtindre un token sk_demo_ temporal i emetre PDF marcats com a DEMO amb dades fictícies. Caduca al cap de 24 hores i no genera documents vàlids per al transport.