API Documentation

Overview
Use this API in your own projects to check for active subscribers via developin.com to offer premium features, content, or services etc.

The developin API allows project owners to check if an email address has an active subscription to their projects. All API requests require authentication using a personal access token.

Getting Started

Follow these steps to start using the API:

  1. Go to your Settings page and find the "API Tokens" section
  2. Create a new token by entering a descriptive name (i.e. "Subscription Checker")
  3. Copy your token immediately - you won't be able to see it again!
  4. Use this token in your API requests as shown below
Authentication

All API requests must include your personal access token in the Authorization header.

Create Token

POST /api/tokens/create

Request body:

{
    "token_name": "My API Token"
}

Response:

{
    "token": "your-token-here",
    "message": "Token created successfully"
}

Using Your Token

Include your token in the Authorization header:

Authorization: Bearer your-token-here
Endpoints

Check Subscription Status

POST /api/subscriptions/check

Checks if an email address has an active subscription to your project.

Request Body:
{
    "email": "[email protected]",
    "project_name": "my-awesome-project"
}
Response:
{
    "has_subscription": true|false,
    "message": "Active subscription found"|"No active subscription found",
    "plan_name": "Pro Plan"|null
}
Notes:
  • You must be the owner of the project to check its subscriptions
  • Results are cached for 1 hour
  • The token must have the subscription:check ability

Manage Tokens

List Tokens:
GET /api/tokens
Delete Token:
DELETE /api/tokens

Request body:

{
    "token_id": "123"
}

Rate Limiting

API requests are subject to rate limiting. If you exceed the limit, you'll receive a 429 Too Many Requests response. Please implement appropriate retry logic in your applications.