API de artefactos de código fuente
Lee los metadatos de las instantáneas de código fuente usados para las compilaciones y la carga del espacio de trabajo. Los artefactos se crean mediante la subida de código fuente y los flujos de compilación.
Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.
| Método | Ruta | Operación |
|---|---|---|
GET | /v1/source_artifact | Listar artefactos de código fuente |
GET | /v1/source_artifact/{id} | Obtener artefacto de código fuente |
Listar artefactos de código fuente
GET /v1/source_artifact
Devuelve una lista paginada de SourceArtifact
Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.
Parámetros
| Nombre | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
X-Tenant-ID | cabecera | sí | ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico. |
page | consulta | no | Número de página |
per_page | consulta | no | Elementos por página |
Ejemplo de solicitud
Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.
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"
Respuesta: HTTP 200
Lista de SourceArtifact
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
data | array | |
data[].branch | string | |
data[].build_id | string | Compilación producida a partir de esta instantánea del código fuente |
data[].commit_sha | string | |
data[].content_type | string | |
data[].created_at | integer | (marca de tiempo Unix) |
data[].deleted_at | integer | (marca de tiempo Unix) |
data[].digest | string | Hash del contenido del paquete de código fuente |
data[].metadata | object | |
data[].repository_url | string | URL del repositorio Git cuando source_type es git |
data[].size_bytes | integer | |
data[].source_artifact_id | string | |
data[].source_type | string | Valores permitidos: upload, git, workspace, template, unknown. |
data[].system_artifact_id | string | Identificador del artefacto de objeto del sistema para el paquete de código fuente |
data[].system_object_key | string | |
data[].system_uri | string | |
data[].team_id | string | |
data[].updated_at | integer | (marca de tiempo Unix) |
data[].workload_id | string | |
pagination | object | |
pagination.page | integer | Número de página actual |
pagination.per_page | integer | Número de elementos por página |
pagination.total | integer | Número total de elementos |
Ejemplo ilustrativo; no es una respuesta real:
{
"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
}
}
Obtener artefacto de código fuente
GET /v1/source_artifact/{id}
Devuelve un único SourceArtifact
Configura source_artifact_id usando IDs de tus propias respuestas de la API.
Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.
Parámetros
| Nombre | Ubicación | Obligatorio | Descripción |
|---|---|---|---|
id | ruta | sí | Identificador del recurso obtenido de los resultados de la API de tu equipo. |
X-Tenant-ID | cabecera | sí | ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico. |
Ejemplo de solicitud
Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.
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"
Respuesta: HTTP 200
SourceArtifact
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
branch | string | |
build_id | string | Compilación producida a partir de esta instantánea del código fuente |
commit_sha | string | |
content_type | string | |
created_at | integer | (marca de tiempo Unix) |
deleted_at | integer | (marca de tiempo Unix) |
digest | string | Hash del contenido del paquete de código fuente |
metadata | object | |
repository_url | string | URL del repositorio Git cuando source_type es git |
size_bytes | integer | |
source_artifact_id | string | |
source_type | string | Valores permitidos: upload, git, workspace, template, unknown. |
system_artifact_id | string | Identificador del artefacto de objeto del sistema para el paquete de código fuente |
system_object_key | string | |
system_uri | string | |
team_id | string | |
updated_at | integer | (marca de tiempo Unix) |
workload_id | string |
Ejemplo ilustrativo; no es una respuesta real:
{
"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"
}