Autenticación
Una clave de cuenta en un encabezado. Sin sesión, sin tokens que vencen en medio de una corrida.
El encabezado
Todos los pedidos llevan la clave como Bearer. No hay ningún otro encabezado de identificación: la clave ES la cuenta.
bash
curl https://api.dialsprint.com/api/v1/contact-fields \
-H "Authorization: Bearer ds_a1b2c3d4e5f6_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Permisos
Cada clave lleva los permisos que le diste al crearla. Escribir implica leer, así que una clave que crea contactos puede releer el que acaba de crear.
- Leer contactos, campos y listas: contacts:read.
- Crear y actualizar contactos: contacts:write.
- Importar de a miles y consultar el estado: imports:write.
- Ver campañas y sumarles contactos: campaigns:read y campaigns:write.
- Leer los hilos de texto: conversations:read.
- Leer los recontactos agendados: callbacks:read.
- Las listas de números que no se llaman: suppressions:read y suppressions:write.
Cuando algo no anda
Una clave que no existe, que revocaste o que venció responde siempre lo mismo, a propósito: quien esté probando claves al azar no aprende cuál de las tres era.
Cada respuesta de error trae un request_id. Es el dato que te vamos a pedir si nos escribís.
json
{
"message": "Invalid or missing API key.",
"message_code": "api_key_invalid",
"request_id": "01M2XEM2ESR7K9A0AR29EDT9WJ"
}Dos cosas que conviene saber de entrada
- La API necesita una cuenta activa, que se activa con la primera carga de saldo: durante la prueba no responde, y no hay un entorno de pruebas aparte. Se integra contra la cuenta real.
- Una clave nunca va en el navegador. Una clave en el navegador es una clave filtrada: usala sólo desde tu servidor.