GET /me

Get information about your application, quota usage, and subscription status.

Endpoint

GET /me

Full URL: https://developer.easyslip.com/api/v1/me

Authentication

Required. See Authentication Guide.

Authorization: Bearer YOUR_API_KEY

Request

No request body required.

Type Definitions

// Response Types
interface MeResponse {
  status: 200;
  data: MeData;
}

interface MeData {
  application: string;
  usedQuota: number;
  maxQuota: number | null;       // null = unlimited
  remainingQuota: number | null;
  expiredAt: string;             // ISO 8601
  currentCredit: number;
}

// Error Response
interface ErrorResponse {
  status: number;
  message: string;
}

Examples

cURL

curl -X GET https://developer.easyslip.com/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const getMe = async () => {
  const response = await fetch('https://developer.easyslip.com/api/v1/me', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const result = await response.json();

  if (result.status !== 200) {
    throw new Error(result.message);
  }

  return result.data;
};

// Usage
const info = await getMe();
console.log('Application:', info.application);
console.log('Remaining Quota:', info.remainingQuota);

PHP

function getMe(): array
{
    $apiKey = getenv('EASYSLIP_API_KEY');

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => 'https://developer.easyslip.com/api/v1/me',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey]
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);

    if ($result['status'] !== 200) {
        throw new Exception($result['message']);
    }

    return $result['data'];
}

// Usage
$info = getMe();
echo "Remaining Quota: " . $info['remainingQuota'];

Python

import requests
import os

def get_me() -> dict:
    response = requests.get(
        'https://developer.easyslip.com/api/v1/me',
        headers={'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}'}
    )

    result = response.json()

    if result['status'] != 200:
        raise Exception(result['message'])

    return result['data']

# Usage
info = get_me()
print(f"Remaining Quota: {info['remainingQuota']}")

Response

Success Response (200)

{
  "status": 200,
  "data": {
    "application": "My Application",
    "usedQuota": 1500,
    "maxQuota": 35000,
    "remainingQuota": 33500,
    "expiredAt": "2025-01-01T00:00:00+07:00",
    "currentCredit": 5000
  }
}

Response Fields

Field	Type	Description
application	string	Application name
usedQuota	number	Quota used this billing period
maxQuota	number | null	Maximum quota (null = unlimited)
remainingQuota	number | null	Remaining quota
expiredAt	string	Subscription expiration date (ISO 8601)
currentCredit	number	Available credit balance

Error Responses

Unauthorized (401)

{
  "status": 401,
  "message": "unauthorized"
}

Access Denied (403)

{
  "status": 403,
  "message": "access_denied"
}

Server Error (500)

{
  "status": 500,
  "message": "server_error"
}

Notes

• This endpoint does not consume quota
• Quota resets based on your billing cycle (monthly or yearly)
• maxQuota: null indicates unlimited quota
• Credit is used for auto-renewal and additional features