myFund.pl API v1
호환성: myFund.pl API v1, 기본 URL https://myfund.pl/API/v1.
출처: 2026-11-03 날짜의 번들 문서 스냅샷. 3.1.0은 OpenAPI 형식 버전이고 1.0.0은 스킬 버전입니다. 둘 다 API 버전이 아닙니다.
API는 베타로 설명됩니다. 다른 버전과의 호환성을 가정하지 마십시오.
작업 선택
| 필요 사항 | 메서드 및 경로 |
|---|---|
| 포트폴리오 목록 | GET /getPortfele.php |
| 보유 종목, 성과, 내역, 배당금, 계좌, 부채 | GET /getPortfel.php |
| JSON 형식의 거래 또는 현금 흐름 | POST /importOperacji.php |
| 브로커 내보내기 파일 | POST /importOperacjiPlik.php |
| 기여금 내역이 포함된 PPK 내보내기 | POST /importOperacjiPPKPlik.php |
요청을 구성하기 전에 references/openapi.yaml에서 관련 엔드포인트와 스키마를 읽으십시오. 실용적인 지침과 예제는 references/workflows.md에 있습니다. 엔드포인트, 가져오기 소스 이름 또는 문서화되지 않은 매개변수를 임의로 만들지 마십시오.
인증 및 실행
메뉴 > 계정 > 계정 설정 > API 키에서 키를 얻으십시오.
키를 재생성하면 이전 키가 무효화됩니다. 환경 변수(예: MYFUND_API_KEY)에서 시크릿을 사용하고, 스킬이나 예제에 저장하지 마십시오.
키, 진단 헤더 또는 개인 데이터가 포함된 전체 URL을 기록하지 마십시오.
단일 시크릿을 찾기 위해 전체 .env 파일을 읽고 표시하지 마십시오.
읽기 작업에는 쿼리에 apiKey가 필요합니다. 가져오기 작업에는 JSON 본문 또는 멀티파트 필드를 사용하십시오.
폴란드어 문자와 정확한 포트폴리오 이름(ID가 아님)을 보존하여 URL 매개변수를 인코딩하십시오.
멀티파트 요청의 경우 클라이언트가 자체 경계로 Content-Type을 생성하도록 하십시오.
HTTP와 status.code를 모두 확인하십시오: "0"은 성공, "1"은 오류, "7"은 포트폴리오가 없음을 의미합니다.
HTTP 200만으로는 성공이 확인되지 않습니다. 응답에 예상된 상태나 데이터가 없으면 불완전한 결과를 보고하십시오.
읽기 작업은 5분 동안 캐시되고 가져오기 작업은 캐시되지 않습니다. 가져오기 후 검색된 데이터가 즉시 업데이트된다고 약속하지 마십시오.
읽기 및 해석
포트폴리오 이름을 모르는 경우 먼저 포트폴리오 목록을 검색하십시오. scope를 제한할 때는 항상 status를 포함하고 필요한 필드만 선택하십시오.
scope는 최상위 수준에만 적용되며 대소문자를 구분합니다.
알 수 없는 필드는 생략됩니다. 필드가 없다고 해서 0을 의미하지는 않습니다.
통화, 날짜 및 단위를 보존하십시오. 숫자 값은 종종 문자열이며 때로는 +가 포함됩니다. 빈 값, --- 및 는 누락된 데이터로 처리하십시오.
전체 객체를 무분별하게 숫자로 변환하지 마십시오. 금액에는 십진 연산을 사용하십시오.
tickers와 내역은 배열이 아닌 맵이며, 시계열은 날짜를 키로 하는 맵입니다.
struktura의 금전적 가치와 strukturaWalory의 주식 수를 혼동하지 마십시오.
가져오기는 포트폴리오를 변경합니다
데이터 준비만으로는 가져오기 제출이 승인되지 않습니다. 사용자가 요청할 때만 가져오기를 실행하고, 이미 주어진 승인에 대해 다시 묻지 마십시오. 제출하기 전에 포트폴리오, 데이터, 계좌, 파일 소스 및 중복 정책을 설정하십시오. 쓰기에 영향을 미치는 정보가 누락된 경우 미리보기를 준비하고 요청하십시오. 알 수 없는 가격, 수량, 날짜 또는 세금을 임의로 채우지 마십시오.
duplikaty=1과 sprawdzCene="true"를 기본값으로 유지하십시오.
duplikaty=2는 작업을 중복시킬 수 있으므로 명시적인 지시가 있을 때만 사용하십시오.
가져오기가 원자적이거나 멱등적이라고 가정하지 마십시오. 시간 초과 또는 연결 끊김 후 POST를 자동으로 재시도하지 말고, 캐시를 고려하여 내역과 가져오기 상태를 확인하십시오.
문서화된 드라이런 모드는 없습니다. 로컬 미리보기는 서버 유효성 검사가 아닙니다.
완료 후 응답에 있을 때 상태, 작업 수, 누락 및 가장 빠른 날짜를 보고하십시오.
요청 준비와 실행된 가져오기를 구분하십시오.