Questa guida ti aiuterà a fare la tua prima chiamata API in pochi minuti.
Per autenticare le tue richieste, hai due opzioni:
curl -X POST https://nitro.italianonprofit.it/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"email": "tuo@email.com",
"password": "tua-password"
}'
accessToken e refreshToken:{
"status": "success",
"data": {
"accessToken": "v4.public.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ...",
"refreshToken": "v4.public.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ...",
"expiresIn": 3600
}
}
curl -X POST https://nitro.italianonprofit.it/api/v1/api-keys \
-H "Authorization: Bearer <tuo-access-token>" \
-H "Content-Type: application/json" \
-d '{
"name": "My Integration",
"scopes": ["organizations:read"]
}'
{
"status": "success",
"data": {
"key": "npf_a1b2c3d4_e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6",
"scopes": ["organizations:read"]
}
}
Ora puoi autenticare le tue richieste usando il token o l'API key.
Ecco un esempio pratico di ricerca organizzazioni usando un token PASETO:
curl -X POST https://nitro.italianonprofit.it/api/v1/organizations/search \
-H "Authorization: Bearer <tuo-access-token>" \
-H "Content-Type: application/json" \
-d '{
"index": "db-organizations*",
"body": {
"query": {
"match": {
"name": "associazione"
}
}
}
}'
Oppure usando un'API Key:
curl -X POST https://nitro.italianonprofit.it/api/v1/organizations/search \
-H "Authorization: Bearer npf_a1b2c3d4_e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6" \
-H "Content-Type: application/json" \
-d '{
"index": "db-organizations*",
"body": {
"query": {
"match": {
"name": "associazione"
}
}
}
}'
Le risposte seguono sempre lo stesso formato:
{
"status": "success",
"data": {
"id": 123,
"name": "Esempio Organizzazione",
"tax_code": "12345678901"
},
"meta": {
"requestId": "uuid-unico",
"timestamp": "2024-01-15T10:30:00.000Z"
}
}
{
"status": "error",
"error": {
"code": "UNAUTHORIZED",
"message": "Token non valido o scaduto",
"details": {}
},
"meta": {
"requestId": "uuid-unico",
"timestamp": "2024-01-15T10:30:00.000Z"
}
}
Per maggiori dettagli e esempi avanzati di ricerca, consulta la documentazione completa dell'endpoint di ricerca.
Ora che hai fatto la tua prima chiamata: