API Reference for Developers NEW

Getting Started

An API token is required for requests to be processed by the system. Once a user registers, an API token is automatically generated for this user. The API token must be sent with each request (see full example below). If the API token is not sent or is expired, there will be an error. Please make sure to keep your API token secret to prevent abuse.

API GETCID

To authenticate with the getcid API system, you need to send your API token with each request. You can see the sample code below.

GET /api/{iid}/{token}

{iid}: Installation ID (Windows/Office)
{token}: Verification token you have registered

Example:
{iid}: 539979038249031308832790330685369121397625732562087764155620325
{token}: test1234567
GET /api/539979038249031308832790330685369121397625732562087764155620325/test1234567
One of the values below

Success:
260150672771490322851855366226271886248373443125
Wrong IID.
Blocked IID.
Exceeded IID.
Need to call M$ Support.
Not legimate key. Maybe blocked.

Another:
Sorry, API Token cannot be empty.
Sorry, your API Token does not exist.
Your IP reach request limit.
Your IP is being locked.
Your IID reach request limit.
Your IID is being locked.
Sorry, your API Token has been used 5/5 times.

Server Error:
Server too busy.

API Redeem Microsoft

To perform a check if the digital key is still available

Redeemed: Redeemed
Active: Available

Note:
- Limit in one check is 20 keys

- If you send requests continuously for a short time, the system will think that the request is bad, and will temporarily block your ip

POST /api-key-digital
Content-Type: application/json

[
  {"key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"},
  {"key":"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"}
]

Example:
POST /api-key-digital
[
  {"key":"KQD4T-NJ3FF-RTFXT-RR3GB-JK962"},
  {"key":"CH8XD-GTNJT-K2JWK-D83YG-WXDT2"}
]
Content-type: application/json

Success:
{
  "status":"success",
  "res":[
    {
    "id":0,
    "key":"KQD4T-NJ3FF-RTFXT-RR3GB-JK962",
    "description":"Office Professional Plus 2019"
    "subtype":"X21-74564",
    "key_status":"Redeemed"
    "time":"03/04/2022 11:00:14"
    }
  ]
}

Return value belongs to other cases:
"description":"Sorry, There was an unknown error, please try again."
"description":"Check key digital fail."
"description":"KeyNotSupport"
"description":"Failure"

Error:
{
  "status":"error",
  "res":"Sorry, please enter the key"
}

Error:
{
  "status":"error",
  "res":"Sorry, the website only supports checking up to 20 key for 1 time"
}


API Check Office 365

To check the username and password of the office 365 account is correct or not

Note:
- Limit in one check is 100 accounts

- If you send requests continuously for a short time, the system will think that the request is bad, and will temporarily block your ip

POST /api-check-account-office-365

Content-Type: application/json

[
  {"userName":"{User name}","password":"{Password}"},
  {"userName":"{User name}","password":"{Password}"}
]

Example:
POST /api-check-account-office-365
[
  {"userName":"[email protected]","password":"Qay10285"}
]
Content-type: application/json

Success:
{
  "status":"success",
  "res":[
    {
    "userName":"[email protected]",
    "password":"Qay10285",
    "status_acc":"more_information_required"
    }
  ]
}

Return value belongs to other cases:
"status_acc":"valid"
"status_acc":"verify_identity"
"status_acc":"more_information_required"
"status_acc":"password_is_incorrect_or_account_lock"
"status_acc":"account_lock"
"status_acc":"password_is_incorrect"
"status_acc":"need_update_password"
"status_acc":"account_temporarily_locked"
"status_acc":"tenant_identifying"
"status_acc":"Unknown"
"status_acc":"NotExist"
"status_acc":"Throttled"
"status_acc":"Error"
"status_acc":"Sorry, There was an unknown error, please try again."

Error:
{
  "status":"error",
  "res":"Sorry, Please enter your office 365 account."
}

Error:
{
  "status":"error",
  "res":"Sorry, the website only supports checking up to 100 account for 1 time"
}