Skip to navigation

Primeros pasos

De las credenciales a tu primera llamada, en cinco minutos.

Vas a necesitar dos cosas: el slug de tu organización y el par de credenciales (API key y secret access) que te entrega Crehana.

El slug es el identificador de tu organización dentro de las rutas. Si tu espacio es https://www.crehana.com/org/acme/, tu slug es acme.

1. Verificá que tus credenciales funcionan

La llamada más barata para probar es listar las áreas de tu organización:

curl https://www.crehana.com/api/v5/rest/org/acme/organizations/areas/ \
-H "Api-Key: $API_KEY" \
-H "Secret-Access: $SECRET_ACCESS"

Si las credenciales son correctas vas a recibir un 200 con el total y la página de resultados:

{
"total": 12,
"results": [
{ "id": 1, "name": "Tecnología" },
{ "id": 2, "name": "Comercial" }
]
}

Si en cambio te llega un 401, revisá los dos headers: van siempre juntos, y falta uno alcanza para que el request se rechace.

{
"detail": {
"errors": ["AuthenticationError: User is not authenticated in centralized"]
}
}

2. Traé tus usuarios

curl "https://www.crehana.com/api/v5/rest/org/acme/users/user-organizations/?limit=10" \
-H "Api-Key: $API_KEY" \
-H "Secret-Access: $SECRET_ACCESS"

Existe también /users/user-organizations/basic/, que devuelve menos campos por usuario. Si solo necesitás identificar personas —y no su estructura completa— es bastante más liviano.

3. Elegí por dónde seguir