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:

1{
2 "total": 12,
3 "results": [
4 { "id": 1, "name": "Tecnología" },
5 { "id": 2, "name": "Comercial" }
6 ]
7}

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

1{
2 "detail": {
3 "errors": ["AuthenticationError: User is not authenticated in centralized"]
4 }
5}

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