TempOtp Mail API Documentation

TempOtp Mail API Documentation

1. Get Service

URL:

https://tempotp.org/stubs/handler_api.php?key=$api_key&action=getMailServices
Success Response:
{
                            "result": "success",
                            "data": [
                                {"name": "AMAZON", "code": "amazon.in"},
                                {"name": "YOUTUBE", "code": "youtube.com"}
                            ]
                        }
Error Responses:
Error TypeExample Response
BAD_KEY
{"result": "failed", "type": "BAD_KEY", "message": "$message"}
BAD_PARAMS
{"result": "failed", "type": "BAD_PARAMS", "message": "$message"}
NOT_IN_SERVICE
{"result": "failed", "type": "NOT_IN_SERVICE", "message": "$message"}
SYSTEM_ERROR
{"result": "failed", "type": "SYSTEM_ERROR", "message": "$message"}

2. Get Domain

URL:

https://tempotp.org/stubs/handler_api.php?key=$api_key&action=getMailDomains&service=site.com
Success Response:
{
                                "result": "success",
                                "data": [
                                    {"name": "mail.ru", "price": 4, "count": "317543"},
                                    {"name": "list.ru", "price": 4, "count": "129254"}
                                ]
                            }
Error Responses:
Error TypeExample Response
BAD_KEY
{"result": "failed", "type": "BAD_KEY", "message": "$message"}
BAD_PARAMS
{"result": "failed", "type": "BAD_PARAMS", "message": "$message"}
NOT_IN_SERVICE
{"result": "failed", "type": "NOT_IN_SERVICE", "message": "$message"}
SYSTEM_ERROR
{"result": "failed", "type": "SYSTEM_ERROR", "message": "$message"}

3. Get Mail Address

URL:

https://tempotp.org/stubs/handler_api.php?key=$api_key&action=getMailAddress&domain=domain.com&service=site.com
Success Response:
{
                            "result": "success",
                            "data": {
                                "id": "SN1713079205652140",
                                "mail": "yourmailid@domain.com",
                                "price": 4
                            }
                        }
Error Responses:
Error TypeExample Response
BAD_KEY
{"result": "failed", "type": "BAD_KEY", "message": "$message"}
BAD_PARAMS
{"result": "failed", "type": "BAD_PARAMS", "message": "$message"}
NOT_IN_SERVICE
{"result": "failed", "type": "NOT_IN_SERVICE", "message": "$message"}
SYSTEM_ERROR
{"result": "failed", "type": "SYSTEM_ERROR", "message": "$message"}
BAD_BALANCE
{"result": "failed", "type": "BAD_BALANCE", "message": "$message"}

4. Get Message

URL:

https://tempotp.org/stubs/handler_api.php?key=$api_key&action=getMessage&id=SN123456789010
Success Response:
{
                            "result": "success",
                            "type": "WAIT_LINK",
                            "message": "Waiting for mail"
                        }
Error Responses:
Error TypeExample Response
BAD_KEY
{"result": "failed", "type": "BAD_KEY", "message": "$message"}
BAD_PARAMS
{"result": "failed", "type": "BAD_PARAMS", "message": "$message"}
SYSTEM_ERROR
{"result": "failed", "type": "SYSTEM_ERROR", "message": "$message"}
NO_ACTIVATION
{"result": "failed", "type": "NO_ACTIVATION", "message": "$message"}
WAIT_LINK
{"result": "failed", "type": "WAIT_LINK", "message": "$message"}

5. CancelMail

URL:

https://tempotp.org/stubs/handler_api.php?key=$api_key&action=cancelMail&id=SN123456789010
Success Response:
{
                "result": "success",
                "data": {
                    "message": "Activation successfully canceled"
                }
            }
Error Responses:
Error TypeExample Response
BAD_KEY
{"result": "failed", "type": "BAD_KEY", "message": "$message"}
BAD_PARAMS
{"result": "failed", "type": "BAD_PARAMS", "message": "$message"}
SYSTEM_ERROR
{"result": "failed", "type": "SYSTEM_ERROR", "message": "$message"}
ACTIVATION_CANCELED
{"result": "failed", "type": "ACTIVATION_CANCELED", "message": "$message"}
NO_ACTIVATION
{"result": "failed", "type": "NO_ACTIVATION", "message": "$message"}
WAIT_LINK
{"result": "failed", "type": "WAIT_LINK", "message": "$message"}