Autenticación
Echo de prueba
Valida toda la cadena de firma y devuelve la identidad de la aplicación que llama.
/openapi/demo/echoRequiere las cabeceras de firma token, timestamp y sign, vea Autenticación.
Recomendado como primera llamada de toda integración: si la firma es correcta, la respuesta devuelve el mensaje enviado junto con el appKey de la aplicación. A diferencia de los endpoints estándar, echo responde con el sobre de la plataforma (success / data).
Parámetros
Cabeceras
Content-TypestringobligatorioSiempre
application/json.
Cuerpo de la petición
messagestringobligatorioCualquier texto de hasta 512 caracteres; se devuelve sin cambios en
data.echo.Ejemplo:hello tffiscal
Respuestas
Firma aceptada. Sobre de la plataforma con el mensaje devuelto y la identidad de la aplicación.
successbooleanResultado de la llamada.
messagestringOKen caso de éxito.dataobjectCarga útil de la respuesta.
Errores
| Código | HTTP | |
|---|---|---|
| 10009000 | 401 | Faltan cabeceras de firma ( |
| 10009001 | 401 | Timestamp inválido o fuera de la ventana de ±300 s. |
| 10009002 | 401 | Token inválido. |
| 10009003 | 401 | Firma no coincide. Vea la sección de solución de problemas en Autenticación. |
| 10009005 | 403 | Aplicación no suscrita al scope |
Cómo usarlo durante la integración
Haga una llamada con cuerpo JSON y otra llamada GET a cualquier endpoint estándar con cuerpo vacío antes de continuar: los dos casos cubren ambas reglas de firma (cuerpo sin CR/LF y cuerpo vacío). La plataforma también ofrece un asistente de firma en la consola: indique el path y el cuerpo exacto y devuelve token / timestamp / sign esperados más un comando curl listo para ejecutar.