Visión general de la autenticación
La API de OrcaRail admite dos métodos de autenticación para distintos casos de uso. Inicia sesión en el panel; el acceso al panel usa tokens Bearer (se obtienen al iniciar sesión). Si es la primera vez que inicias sesión, debes crear una organización antes de poder seguir usando el panel o crear claves de API.
Métodos de autenticación
1. Token Bearer (JWT)
Usa tokens Bearer para peticiones autenticadas por un usuario, por ejemplo cuando un usuario con sesión iniciada crea un Payment Intent o gestiona recursos de su organización.
Caso de uso: aplicaciones de cara al usuario, acceso al panel, operaciones específicas del usuario
Formato de la cabecera:
Authorization: Bearer YOUR_JWT_TOKEN
2. Clave de API (Basic Auth)
Usa claves de API para peticiones de servidor a servidor, como servicios backend que hacen llamadas a la API. Las claves de API se crean dentro de una organización.
Caso de uso: comunicación de servidor a servidor, procesos automatizados, webhooks
Formato de la cabecera:
Authorization: Basic base64(key:secret)
Elegir un método de autenticación
| Escenario | Método recomendado |
|---|---|
| Un usuario crea un pago desde tu app | Token Bearer (JWT) |
| Un servicio backend crea pagos | Clave de API (Basic Auth) |
| Acceso al panel | Token Bearer (JWT) |
| Procesamiento de webhooks | Clave de API (Basic Auth) |
| Llamadas a la API desde una app móvil | Token Bearer (JWT) |
Próximos pasos
- Claves de API: aprende a crear y usar claves de API
- Tokens Bearer: aprende a autenticarte con tokens JWT