# Space3 API In-game Missions Integration Guide

1. ## Introduction

\- This API missions system is designed for Space3 to get verification responses from game partners to verify their in-game missions on Space3 via inputting users’ information of Space3 User ID, email, EVM wallet address, Twitter ID and Discord ID.

\- By implementing this initiative, games can proactively customize their API and endpoints to host diverse in-game missions seamlessly.

**API integration process:**

\- Preparation of API endpoint and response based on Space3’s standard format

\- Submit the API endpoint and response to the Space3 development team

\- API in-game missions will be organized and tested by the Space3 team before launching officially

2. ## Space3’s standard API endpoint format:

**2.1. Method:** GET

Header (Optional):&#x20;

\- HTTP request headers are relevant to the request method (GET) and may be specified on the method request but are not required.&#x20;

\- The game can set custom headers for individual requests that will be used to call the game's API endpoint. Suppose the game's API endpoint needs security to access. The game can add authentication or x-api-key or any key parameters in the header and it will be used to call your API for security.

**2.2. Standard format:**

```

“Your API URL”?uid={uid}&email={email}&wallet={wallet}&twitterId={twitterId}&discordId={discordId}

```

Notes:

* Twitter ID: You can remove the \&twitterId={twitterId} parameter or any other fields from the verification process if you don't need it. Most games only use email and wallet for verification.
* Email: If your system uses "mail" instead of "email" for email addresses, please change the parameter in the endpoint URL from \&email={email} to \&mail={email}.
* API Header: The API header is optional. You can choose to make your API endpoint public or add an API key to make it more secure. We support both options.

**2.3. Sample API endpoint from the game:**

```

http://www.ancient8.gg/api/verifyTask?uid={uid}&email={email}&wallet={wallet}&twitterId={twitterId}&discordId={discordId}

```

**2.4. Sample Space3 verification request:**

```

http://www.ancient8.gg/api/verifyTask?uid=64abd6o0a2fb10mla8cb9995&email=example@email.com&wallet=0x6c7alcms8e873f41d09bfc92f10853ae971c159d&twitterId=1588460159692525569&discordId=56283801224455930

```

```

curl -L -X GET 'http://www.ancient8.gg/api/verifyTask?uid=64abd6o0a2fb10mla8cb9995&email=example@email.com&wallet=0x6c7alcms8e873f41d09bfc92f10853ae971c159d&twitterId=1588460159692525569&discordId=56283801224455930'

```

**2.5. Sample Space3 verification request with custom headers for individual requests:**

**Example 1:**&#x20;

```
curl -L -X GET 'http://www.ancient8.gg/api/verifyTask?email=example@email.com' \
-H 'Accept-Encoding: *' \
-H 'x-partner-key: felfmlkkjakljdls73f4b3fdsfdscsdc' \
```

**Example 2:**&#x20;

```
curl -L -X GET 'http://www.ancient8.gg/api/verifyTask?email=example@email.com' \
-H 'X-API-KEY: felfmlkkjakljdls73f4b3fdsfdscfdsfsdfs' \
```

3. ## Space3’s standard response format:

**3.1. Success:**

Status code: 200

```
{
    "success": true
}
```

**3.2. Failed:**

Status code: 200

```
{
    "success": false
}
```

<figure><img src="https://lh3.googleusercontent.com/daFDdqc1MC0JeFbzDULjwozs0Z86c-dmXSEuaDR-sA-Avo9kOB2uDrzGmAugEG6Cva6QSBA3sLXy-ijpZ0Vw5ZandFzGqISfYSMhmYGDndsgyNIASvMYXGEyFFT3yzg8RzfqN0oz4XqXHhx1dpGiaBI" alt=""><figcaption></figcaption></figure>

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.space3.gg/support/space3-api-in-game-missions-integration-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
