---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/api-start.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/api-start.md
  - href: ru/sourcecraft/operations/api-start.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

# Работа с REST API SourceCraft

Чтобы настроить автоматизацию и интеграцию SourceCraft в свои проекты, используйте публичный REST API сервиса.

Доступны следующие ресурсы с документацией API:
* [Описание методов (англ.)](https://sourcecraft.dev/portal/docs/ru/api-ref/index.md)
* [Интерактивный справочник (англ.)](https://api.sourcecraft.tech/docs/index.html)
* [JSON-спецификация](https://api.sourcecraft.tech/sourcecraft.swagger.json)

Для аутентификации в API используйте [персональный токен (PAT)](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/pat.md). Например, получите список [задач](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#issues) пользователя:

```bash
export PAT=<персональный_токен>
curl \
  --request GET \
  --header "Authorization: Bearer $PAT" \
  --url "https://api.sourcecraft.tech/me/issues" | jq
```

<!-- source: ru/_includes/sourcecraft/ci-cd/ci-cd-api-auth-tip.md -->
{% note tip %}

Для аутентификации в API SourceCraft изнутри [CI/CD](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md)-процесса предусмотрена [предопределенная переменная окружения](https://sourcecraft.dev/portal/docs/ru/sourcecraft/ci-cd-ref/predefined-variables.md) `SOURCECRAFT_TOKEN`.

{% cut "Пример .sourcecraft/ci.yaml" %}

<!-- source: ru/_includes/sourcecraft/ci-cd/src-token-example.md -->
```yaml
on:
  push: test-workflow
workflows:
  test-workflow:
    tasks:
      - name: issues-task
        cubes:
          - name: i-have-got-issues
            script:
              - |
                curl \
                  --header "Authorization: Bearer $SOURCECRAFT_TOKEN" \
                  --url "https://api.sourcecraft.tech/me/issues"
```
<!-- endsource: ru/_includes/sourcecraft/ci-cd/src-token-example.md -->

{% endcut %}

{% endnote %}
<!-- endsource: ru/_includes/sourcecraft/ci-cd/ci-cd-api-auth-tip.md -->

### Примеры {#examples}

* [Работа с приглашениями с помощью API](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/invite.md#api)
* [Назначить роль пользователю в репозитории с помощью API](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/bind.md#api)

#### Полезные ссылки {#see-also}

* [Описание методов (англ.)](https://sourcecraft.dev/portal/docs/ru/api-ref/index.md)
* [Интерактивный справочник (англ.)](https://api.sourcecraft.tech/docs/index.html)
* [JSON-спецификация](https://api.sourcecraft.tech/sourcecraft.swagger.json)
* [Как начать работать с SourceCraft CLI](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/cli-quickstart.md)
* [Взаимосвязь ресурсов SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md)
* [Управление доступом в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md)
*