Get a file blob¶

GET /api/v5/repos/{owner}/{repo}/git/blobs/{sha}

This endpoint retrieves the file Blob content for the specified repository and file Blob SHA. It returns the content size, resource access URL, the Base64-encoded content, and its encoding method.

Access token support¶

• AtomGit user access tokens (AtomGit user access tokens)

Anonymous access¶

This endpoint allows anonymous access.

Request parameters¶

Response parameters¶

Error responses¶

The following are examples of errors this endpoint may return; the error field names are subject to the actual backend response. If you cannot confirm them, refer to the actual response.

400 Invalid parameters

{
  "error": "invalid_request",
  "message": "Invalid parameters"
}

401 Unauthenticated

{
  "error": "unauthorized",
  "message": "Missing or invalid access token"
}

404 Resource not found

{
  "error": "not_found",
  "message": "The file Blob does not exist"
}

HTTP response status codes¶

Request example¶

Parameter notes¶

Replace <owner> with the namespace address the repository belongs to (enterprise, organization, or personal path); replace <repo> with the repository path (path); replace <sha> with the Blob SHA of the file.

This endpoint allows anonymous access, so the examples can omit the access token. If needed, you can include an AtomGit user access token.

cURL¶

curl -X GET 'https://api.atomgit.com/api/v5/repos/<owner>/<repo>/git/blobs/<sha>' -H 'Accept: application/json'

JavaScript¶

// Native fetch (Node.js 18+ / browser)
const response = await fetch("https://api.atomgit.com/api/v5/repos/<owner>/<repo>/git/blobs/<sha>", {
  headers: {
    "Accept": "application/json",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

Python¶

import requests

resp = requests.get(
    "https://api.atomgit.com/api/v5/repos/<owner>/<repo>/git/blobs/<sha>",
    headers={
        "Accept": "application/json",
    },
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

Response example¶

Status code: 200

{
  "sha": "e5699fe1b360d6c799ee58b24fb5a670b1e14851",
  "size": 19,
  "url": "https://api.atomgit.com/api/v5/repos/daming_1/zhu_di/git/blobs/e5699fe1b360d6c799ee58b24fb5a670b1e14851",
  "content": "JXU2RDRCJXU4QkQ1d2ViaG9vaw==",
  "encoding": "base64"
}

Error codes¶