Artículo 3 de 8

La documentación y el acceso de prueba

Una referencia completa de la API y una cuenta de prueba lista para usar, para probarla sin riesgo.

La referencia

La referencia de la API (en formato OpenAPI, consultable en Swagger) describe cada llamada abierta a los profesionales: sus parámetros, sus respuestas, sus ejemplos y sus códigos de error. Abarca:

  • los relojes y los pasaportes: creación, modificación, fotos, vinculación de la tarjeta;
  • los propietarios: declaración en la venta, cambio de propietario;
  • el historial y la garantía de un pasaporte;
  • sus detallistas y sus centros de servicio, y su stock en ellos;
  • el pedido de una certificación.

Está abierta, sin credenciales, en https://api.watchcertificate.org/api/v1/doc.

El acceso de prueba

Le abrimos una cuenta en nuestro entorno de pruebas, separado de producción. Contiene:

  • una cuenta profesional validada, con su contraseña;
  • su clave API;
  • un lote de tarjetas de prueba, con su número y su código;
  • créditos, para vincular esas tarjetas;
  • un pasaporte de ejemplo, para ver cómo es el resultado.

Las tarjetas de prueba solo existen en el entorno de pruebas: en producción, cada tarjeta es una tarjeta física, entregada con el reloj.

Pasar a producción

Las llamadas son las mismas. Crea una clave API en su cuenta de producción, cambia la dirección de la API y usa sus tarjetas reales.

Artículo siguienteQuién llama a quién