설명
aukimi.com에서 프로젝트에 선언한 API 연결을 통해 서드파티 서비스에 요청을 보냅니다. 작업 id를 반환합니다.
정의
구문 · 1
ApiRequest(connexion string, methode string, chemin string) → integer구문 · 2
ApiRequest(connexion string, methode string, chemin string, corps string) → integer매개변수
| 이름 | 타입 | 해당 형식 | 의미 |
|---|---|---|---|
| connexion | string | 전체 | API 연결의 이름이며 aukimi.com에 선언한 그대로입니다. |
| methode | string | 전체 | HTTP 메서드입니다. GET, POST, PUT 또는 DELETE이며 대소문자는 구분하지 않습니다. |
| chemin | string | 전체 | 서비스에서 호출할 경로입니다(예: /scores). 쿼리 문자열을 붙일 수 있습니다: /search?q=x. |
| corps | string | 2 | 선택적 요청 본문입니다. JSON으로 읽히는 텍스트는 JSON으로, 그 밖에는 일반 텍스트로 보냅니다. |
반환값
integer
ApiDone(), ApiStatus(), ApiResponse(), ApiJson(), ApiError()에서 쓰는 작업 id입니다.
예제
이 예제는 시그니처를 바탕으로 생성되었습니다. 실행하기 전에 아래의 참고 사항과 필요한 리소스를 확인하세요.
형식 1: 짧은 형식
result = ApiRequest("value", "value", "value")DO Print(result) Sync()LOOP형식 2: 모든 인수 포함
result = ApiRequest("value", "value", "value", "value")DO Print(result) Sync()LOOPApiRequest을(를) 시그니처가 요구하는 타입의 값으로 호출합니다. DO … LOOP는 장식이 아닙니다. 클래식 BASIC 프로그램은 줄이 끝나면 곧바로 종료되며, Sync()가 프레임을 그립니다.
참고 사항
- 서비스의 비밀 키는 Aukimi의 서버에 남아 있으며, 게임은 연결 이름만 압니다.
- 먼저 플레이어가 로그인해야 합니다(PlayerGuestAsync()면 충분합니다). 그렇지 않으면 작업이
not logged in으로 즉시 실패합니다. - 읽고 나면 ApiFree()로 작업을 해제하세요.
- 에디터와 HTML5 내보내기 전용입니다. 네이티브(Bevy) 빌드는 지원되지 않는 명령 오류로 멈춥니다.