Anvil API Python 라이브러리 소개

Anvil API는 이제 공식 클라이언트 라이브러리를 통해 Python에서 지원됩니다. 라이브러리는 현재 GitHub에서 사용할 수 있습니다.

안빌코 / 파이썬 모루

Anvil API용 Python 라이브러리 및 CLI

pip install python-anvil 또는 선호하는 패키지 관리자(예: pipenv, poem)를 통해 PyPI를 통해 패키지로.

회사로서 우리는 Javascript 생태계에 막대한 투자를 하고 있습니다. 그러나 플랫폼을 더 개발자 친화적으로 만들고 다른 개발자가 액세스할 수 있도록 하는 것은 공식 API 라이브러리 공간을 늘리는 것을 의미한다는 것도 알고 있습니다. 그래서 개발자 친화적인 Anvil을 구축하기 위한 또 다른 단계로 클라이언트 라이브러리에 Python을 추가했습니다. 우리는 이 릴리스가 개발자에게 Anvil이 제공하는 모든 것을 즐길 수 있는 기회를 제공하기를 바랍니다.

이 초기 릴리스의 기능:

현재 Javascript 라이브러리에 맞춰 다음을 포함합니다.

Filling PDFs

Generating PDFs

Creating Etch Signing Packets

A command-line interface (CLI)

Python REPL에서 기능을 테스트할 수 있는 기능을 제공하는 위의 내용이 포함되어 있습니다.

이 패키지의 anvil 명령에는 "fill-pdf"에서 사용할 PDF 템플릿(또는 캐스트) 목록 가져오기와 같이 통합을 구축할 때 도움이 되는 몇 가지 추가 유용한 명령도 있습니다. API 끝점 및 특정 PDF 템플릿에서 필드 데이터 가져오기. 이 모든 작업은 텍스트 기반 터미널에서 편리하게 수행할 수 있습니다.

PDF 채우기

Filling PDFs을 사용하면 간단한 API 호출로 Anvil에서 생성된 PDF 템플릿을 채울 수 있습니다.

먼저 Anvil 대시보드에서 템플릿을 만듭니다.



업로드되면 Anvil이 필드를 찾으려고 시도합니다. 또한 고유한 필드를 만들고 날짜 형식과 같은 특정 항목이 필요한 경우 필드 유형을 조정할 수 있습니다.

필드 편집을 마치면 API 정보 탭을 클릭합니다. 빠르게 시작하기 위한 예제 페이로드를 포함하여 API로 템플릿을 채우는 데 필요한 모든 것을 보여줍니다.



API 정보 페이지의 데이터를 사용하여 이제 API 호출을 생성할 수 있습니다. 결과response는 PDF 파일이 됩니다.

from python_anvil.api import Anvil

anvil = Anvil(api_key="MY API KEY")
data = {
    "title": "IRS W-4",
    "font_size": 10,
    "data": {
        "someFieldName": "Example data",
        "aNumberField": 1234
    }
}
response = anvil.fill_pdf("template_id_here", data)

PDF 생성

Anvil API를 사용하면 제공된 JSON 데이터를 사용할 수도 있습니다generate new PDFs. 계약, 송장, 공개 또는 기타 텍스트가 많은 문서에 유용합니다.

from python_anvil.api import Anvil

anvil = Anvil(api_key="MY API KEY")
data = {
    "title": "Example Invoice",
    "font_size": 12,
    "data": [{
        "content": "Supports **markdown**",
    }, {
        "table": {
            "rows": [
                ["Description", "Quantity", "Price"],
                ["4x Large Widgets", "4", "$40.00"],
                ["10x Medium Sized Widgets in dark blue", "10", "$100.00"],
                ["6x Small Widgets in white", "6", "$60.00"],
            ]
        }
    }]
}

response = anvil.generate_pdf("template_id_here", data)

에칭 서명 패킷 생성

Anvil Etch E-sign API을 사용하면 앱 내에서 전자 서명을 수집할 수 있습니다. 여러 PDF, 이미지 및 기타 업로드를 포함하는 서명 패킷을 한 명 이상의 서명자에게 보냅니다. 일반적인 PDF를 템플릿화합니다. 그런 다음 서명 패킷을 보내기 전에 사용자 정보를 입력하십시오.

이것은 API에서 더 복잡한 방법 중 하나이므로 프로세스에 대한 자세한 내용은 Python Anvil docs을 참조하십시오.

명령줄 인터페이스

포함된 CLI를 사용하면 위의 메서드에 빠르게 액세스할 수 있을 뿐만 아니라 브라우저를 열지 않고도 특정 데이터를 가져오는 데 도움이 되는 몇 가지 추가 GraphQL 쿼리를 사용할 수 있습니다.
anvil 명령을 단독으로 실행하면 지원 명령이 표시됩니다. 각 개별 명령에는 명령 사용 방법에 대한 추가 도움말 문서도 있습니다.

# The CLI commands will use the environment variable "ANVIL_API_KEY" for all
# Anvil API requests.
$ ANVIL_API_KEY=MY_GENERATED_KEY anvil
Usage: anvil [OPTIONS] COMMAND [ARGS]...

Options:
  --debug / --no-debug
  --help                Show this message and exit.

Commands:
  cast                Fetch Cast data given a Cast eid.
  create-etch         Create an etch packet with a JSON file.
  current-user        Show details about your API user
  download-documents  Download etch documents
  fill-pdf            Fill PDF template with data
  generate-etch-url   Generate an etch url for a signer
  generate-pdf        Generate a PDF
  weld                Fetch weld info or list of welds

마지막으로 PDF 및/또는 서류 작업 자동화로 멋진 것을 개발하고 있다면 더 많은 소식을 듣고 싶습니다! 피드백이 있으면 (이메일 여기)로 알려주십시오. 또한 이 라이브러리에 대해 발생할 수 있는 새로운 기능이나 문제에 대한 제안이 있는 경우 GitHub 리포지토리 페이지의 문제 섹션에서 알려주시면 연락드리겠습니다.