Endpoint “companies”
Un’azienda rappresenta un’organizzazione del cliente, in genere una divisione dell’azienza. Nell’API di Reactor, queste aziende corrispondono 1:1 all’ID organizzazione. Gli utenti API possono vedere solo le aziende a cui hanno accesso. Un’azienda può contenere molte proprietà. Una proprietà appartiene a una sola azienda.
L’endpoint /companies
nell’API di Reactor consente di recuperare in modo programmatico le aziende a cui hai accesso all’interno dell’applicazione Experience.
Introduzione
L’endpoint utilizzato in questa guida fa parte dell’API di Reactor. Prima di continuare, consulta la guida introduttiva per informazioni importanti su come eseguire l’autenticazione nell’API.
Recuperare un elenco di aziende list
Per elencare le aziende che sei autorizzato a utilizzare, devi eseguire una richiesta di GET all’endpoint /companies
. Nella maggior parte dei casi ce n'è solo una.
Formato API
GET /companies
created_at
name
org_id
token
updated_at
Richiesta
curl -X GET \
https://reactor.adobe.io/companies \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-H 'Accept: application/vnd.api+json;revision=1'
Risposta
In caso di esito positivo, la risposta restituisce l’elenco delle aziende a cui hai accesso.
{
"data": [
{
"id": "COdb0cd64ad4524440be94b8496416ec7d",
"type": "companies",
"attributes": {
"created_at": "2020-08-13T17:13:30.667Z",
"name": "Example Company",
"org_id": "{ORG_ID}",
"updated_at": "2020-08-13T17:13:30.667Z",
"token": "d5a4f682bbae",
"cjm_enabled": false,
"edge_enabled": false,
"edge_events_allotment": null,
"edge_fanout_ratio": null
},
"relationships": {
"properties": {
"links": {
"related": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/properties"
}
}
},
"links": {
"self": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d",
"properties": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/properties"
},
"meta": {
"rights": [
"develop_extensions",
"manage_properties"
],
"platform_rights": {
"web": [
"develop_extensions",
"manage_properties"
],
"mobile": [
"develop_extensions",
"manage_properties"
]
}
}
}
],
"meta": {
"pagination": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 1
}
}
}
Cercare un’azienda lookup
Puoi cercare un’azienda specifica includendo il relativo ID nel percorso di una richiesta GET.
Formato API
GET /companies/{COMPANY_ID}
{COMPANY_ID}
id
dell’azienda da cercare.Richiesta
curl -X GET \
https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H "Content-Type: application/vnd.api+json" \
-H 'Accept: application/vnd.api+json;revision=1'
Risposta
In caso di esito positivo, la risposta restituisce i dettagli dell’azienda.
{
"data": {
"id": "COdb0cd64ad4524440be94b8496416ec7d",
"type": "companies",
"attributes": {
"created_at": "2020-08-13T17:13:30.667Z",
"name": "Example Company",
"org_id": "{ORG_ID}",
"updated_at": "2020-08-13T17:13:30.667Z",
"token": "d5a4f682bbae",
"cjm_enabled": false,
"edge_enabled": false,
"edge_events_allotment": null,
"edge_fanout_ratio": null
},
"relationships": {
"properties": {
"links": {
"related": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/properties"
}
}
},
"links": {
"self": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d",
"properties": "https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/properties"
},
"meta": {
"rights": [
"develop_extensions",
"manage_properties"
],
"platform_rights": {
"web": [
"develop_extensions",
"manage_properties"
],
"mobile": [
"develop_extensions",
"manage_properties"
]
}
}
}
}