API degli artefatti sorgente
Leggi i metadati delle istantanee del codice sorgente usate per le compilazioni e il caricamento degli spazi di lavoro. Gli artefatti vengono creati tramite il caricamento del codice sorgente e i workflow di compilazione.
Usa Autenticazione API per le richieste protette. Gli esempi usano i tuoi ID di risorse e un token temporaneo; gli esempi di risposte salvate sono sintetici.
| Metodo | Percorso | Operazione |
|---|---|---|
GET | /v1/source_artifact | Elenca gli artefatti sorgente |
GET | /v1/source_artifact/{id} | Ottieni un artefatto sorgente |
Elenca gli artefatti sorgente
GET /v1/source_artifact
Restituisce un elenco paginato di SourceArtifact
Autenticazione: token bearer e intestazione del team mostrate di seguito.
Parametri
| Nome | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
X-Tenant-ID | header | Sì | ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico. |
page | query | No | Numero di pagina |
per_page | query | No | Elementi per pagina |
Esempio di richiesta
Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.
curl --fail-with-body --request GET "$ADIOS_API_URL/v1/source_artifact" \
-H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
-H "X-Tenant-ID: $ADIOS_TEAM_ID"
Risposta: HTTP 200
Elenco di SourceArtifact
Campi di risposta
| Campo | Tipo | Descrizione |
|---|---|---|
data | array | |
data[].branch | string | |
data[].build_id | string | Compilazione prodotta da questa istantanea del codice sorgente |
data[].commit_sha | string | |
data[].content_type | string | |
data[].created_at | integer | (timestamp Unix) |
data[].deleted_at | integer | (timestamp Unix) |
data[].digest | string | Digest del contenuto del pacchetto sorgente |
data[].metadata | object | |
data[].repository_url | string | URL del repository Git quando source_type è git |
data[].size_bytes | integer | |
data[].source_artifact_id | string | |
data[].source_type | string | Valori consentiti: upload, git, workspace, template, unknown. |
data[].system_artifact_id | string | Identificativo dell’artefatto oggetto di sistema per il pacchetto sorgente |
data[].system_object_key | string | |
data[].system_uri | string | |
data[].team_id | string | |
data[].updated_at | integer | (timestamp Unix) |
data[].workload_id | string | |
pagination | object | |
pagination.page | integer | Numero di pagina attuale |
pagination.per_page | integer | Numero di elementi per pagina |
pagination.total | integer | Numero totale di elementi |
Esempio illustrativo; non è una risposta dal vivo:
{
"data": [
{
"branch": "",
"build_id": "example",
"commit_sha": "",
"content_type": "",
"created_at": 1791072000,
"deleted_at": 0,
"digest": "",
"metadata": {},
"repository_url": "example",
"size_bytes": 0,
"source_artifact_id": "000000000000000000000000001",
"source_type": "unknown",
"system_artifact_id": "example",
"system_object_key": "",
"system_uri": "",
"team_id": "000000000000000000000000001",
"updated_at": 1791072000,
"workload_id": "000000000000000000000000001"
}
],
"pagination": {
"page": 1,
"per_page": 1,
"total": 1
}
}
Ottieni un artefatto sorgente
GET /v1/source_artifact/{id}
Restituisce un oggetto SourceArtifact
Imposta source_artifact_id usando gli ID restituiti dalle tue risposte API.
Autenticazione: token bearer e intestazione del team mostrate di seguito.
Parametri
| Nome | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
id | path | Sì | Identificativo della risorsa ottenuto dai risultati API del tuo team. |
X-Tenant-ID | header | Sì | ID del team attivo. Deve corrispondere al tenant a cui è vincolato il token diagnostico. |
Esempio di richiesta
Imposta ADIOS_API_URL=https://api.adios.dev. Per le richieste protette, imposta ADIOS_ACCESS_TOKEN e ADIOS_TEAM_ID come nel guida rapida. Imposta le eventuali variabili aggiuntive ADIOS_* con i valori ottenuti dalle tue risorse.
curl --fail-with-body --request GET "$ADIOS_API_URL/v1/source_artifact/${ADIOS_SOURCE_ARTIFACT_ID}" \
-H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
-H "X-Tenant-ID: $ADIOS_TEAM_ID"
Risposta: HTTP 200
SourceArtifact
Campi di risposta
| Campo | Tipo | Descrizione |
|---|---|---|
branch | string | |
build_id | string | Compilazione prodotta da questa istantanea del codice sorgente |
commit_sha | string | |
content_type | string | |
created_at | integer | (timestamp Unix) |
deleted_at | integer | (timestamp Unix) |
digest | string | Digest del contenuto del pacchetto sorgente |
metadata | object | |
repository_url | string | URL del repository Git quando source_type è git |
size_bytes | integer | |
source_artifact_id | string | |
source_type | string | Valori consentiti: upload, git, workspace, template, unknown. |
system_artifact_id | string | Identificativo dell’artefatto oggetto di sistema per il pacchetto sorgente |
system_object_key | string | |
system_uri | string | |
team_id | string | |
updated_at | integer | (timestamp Unix) |
workload_id | string |
Esempio illustrativo; non è una risposta dal vivo:
{
"branch": "",
"build_id": "example",
"commit_sha": "",
"content_type": "",
"created_at": 1791072000,
"deleted_at": 0,
"digest": "",
"metadata": {},
"repository_url": "example",
"size_bytes": 0,
"source_artifact_id": "000000000000000000000000001",
"source_type": "unknown",
"system_artifact_id": "example",
"system_object_key": "",
"system_uri": "",
"team_id": "000000000000000000000000001",
"updated_at": 1791072000,
"workload_id": "000000000000000000000000001"
}