📸 Studio Mahoney Film Development API

A comprehensive REST API for film development data, providing accurate development times, temperature compensation, and compatibility information for various films and developers. Data is sourced from digitaltruth.com and updated regularly.

Base URL

https://secure-svr.net/darkroom

Features

Comprehensive film development database
Temperature compensation (17°C to 30°C)
Multiple format support (35mm, 120, sheet)
Developer compatibility checking
ISO-specific development times
Detailed development notes

Temperature Compensation

Development times are automatically adjusted based on temperature using Ilford's standard chart:

Temperature	Adjustment	Example (10min base)
17°C	+75%	17:30
18°C	+45%	14:30
19°C	+20%	12:00
20°C	Base	10:00
21°C	-10%	9:00
22°C	-15%	8:30
23°C	-20%	8:00
24°C	-25%	7:30
25°C	-30%	7:00
26°C	-35%	6:30
27°C	-40%	6:00
28°C	-45%	5:30
29°C	-50%	5:00
30°C	-55%	4:30

Endpoints

GET/

Get API information and list of all available endpoints.

Example Response:

{
  "api_name": "Darkroom Development API",
  "version": "1.0.0",
  "endpoints": {
    "/darkroom/data": "Get all film development data",
    "/darkroom/search": "Search films by name or developer",
    "/darkroom/film/:name/times": "Get development times for each developer option",
    "/darkroom/film/:name/developers": "Get a list of all developers available for a specific film",
    "/darkroom/film/:name": "Get detailed film information",
    "/darkroom/film/:name/temperature/:temp": "Get temperature-adjusted development times for a film",
    "/darkroom/film/:name/isos": "Get available ISO ratings for a film",
    "/darkroom/developer/:name/dilutions": "Get all available dilutions for a developer",
    "/darkroom/films/format/:format": "Get all films available in a specific format",
    "/darkroom/developer/:name/compatible-films": "Get all films compatible with a developer",
    "/health": "API health check"
  }
}

GET/health

Check the API's health status.

Example Response:

{
  "status": "healthy",
  "timestamp": "2025-02-09T22:08:45.000Z"
}

GET/darkroom/data

Retrieve the complete film development database.

Query Parameters:

Parameter	Type	Description
includeNotes	boolean	Include development notes in the response

Example Response:

{
  "metadata": {
    "last_updated": "2025-02-09T12:00:00Z",
    "total_films": 150
  },
  "films": [
    {
      "film_name": "HP5 Plus",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=HP5%20Plus&Developer=&mdc=Search&TempUnits=C&TimeUnits=D",
      "development_options": [
        {
          "developer": "D-76",
          "dilution": "1:1",
          "iso": "ISO 400",
          "temperature": "20°C",
          "development_times": {
            "35mm": "7:30",
            "120": "7:30",
            "sheet": "7:30"
          }
        }
      ]
    }
  ]
}

GET/darkroom/search

Search films by name or developer.

Query Parameters:

Parameter	Type	Description
film	string	Film name to search for
developer	string	Developer name to search for
includeNotes	boolean	Include development notes in the response

Example Response:

{
  "search_parameters": {
    "film": "HP5",
    "developer": null
  },
  "results_count": 1,
  "results": [
    {
      "film_name": "HP5 Plus",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=HP5%20Plus&Developer=&mdc=Search&TempUnits=C&TimeUnits=D",
      "development_options": [
        {
          "developer": "D-76",
          "dilution": "1:1",
          "iso": "ISO 400",
          "temperature": "20°C",
          "development_times": {
            "35mm": "7:30",
            "120": "7:30",
            "sheet": "7:30"
          }
        }
      ]
    }
  ]
}

GET/darkroom/film/:name

Get detailed information about a specific film.

Path Parameters:

Parameter	Type	Description
name	string	Film name

Query Parameters:

Parameter	Type	Description
includeNotes	boolean	Include development notes in the response

Example Response:

{
  "film_name": "HP5 Plus",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=HP5%20Plus&Developer=&mdc=Search&TempUnits=C&TimeUnits=D",
      "development_options": [
        {
          "developer": "D-76",
      "dilution": "1:1",
      "iso": "ISO 400",
      "temperature": "20°C",
      "development_times": {
        "35mm": "7:30",
        "120": "7:30",
        "sheet": "7:30"
      },
      "notes": "Push processing recommended for low light conditions"
    }
  ]
}

GET/darkroom/film/:name/times

Get development times for each developer option for a specific film.

Path Parameters:

Parameter	Type	Description
name	string	Film name

Example Response:

{
  "film_name": "HP5 Plus",
  "development_times": [
    {
      "developer": "D-76",
      "dilution": "1:1",
      "temperature": "20°C",
      "times": {
        "35mm": "7:30",
        "120": "7:30",
        "sheet": "7:30"
      }
    }
  ]
}

GET/darkroom/film/:name/developers

Get a list of all developers available for a specific film.

Path Parameters:

Parameter	Type	Description
name	string	Film name

Example Response:

{
  "film_name": "HP5 Plus",
  "developers": [
    "D-76",
    "HC-110",
    "Rodinal"
  ]
}

GET/darkroom/film/:name/isos

Get available ISO ratings for a specific film.

Path Parameters:

Parameter	Type	Description
name	string	Film name

Example Response:

{
  "film_name": "HP5 Plus",
  "isos": [
    "400",
    "800",
    "1600"
  ]
}

GET/darkroom/film/:name/temperature/:temp

Get temperature-adjusted development times for a specific film.

Path Parameters:

Parameter	Type	Description
name	string	Film name
temp	number	Target temperature (17-30°C)

Query Parameters:

Parameter	Type	Description
developer	string	Filter by developer name
dilution	string	Filter by dilution ratio
iso	string	Filter by ISO rating

Example Response:

{
  "film_name": "HP5 Plus",
  "temperature_adjustment": {
    "base": "20°C",
    "target": "24°C"
  },
  "development_options": [
    {
      "developer": "D-76",
      "dilution": "1:1",
      "iso": "ISO 400",
      "base_temperature": "20°C",
      "target_temperature": "24°C",
      "times": {
        "35mm": {
          "base": "7:30",
          "adjusted": "5:30"
        },
        "120": {
          "base": "7:30",
          "adjusted": "5:30"
        },
        "sheet": {
          "base": "7:30",
          "adjusted": "5:30"
        }
      }
    }
  ]
}

GET/darkroom/films/format/:format

Get all films available in a specific format.

Path Parameters:

Parameter	Type	Description
format	string	Film format (35mm, 120, or sheet)

Example Response:

{
  "format": "35mm",
  "films_count": 2,
  "films": [
    {
      "film_name": "HP5 Plus",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=HP5%20Plus&Developer=&mdc=Search&TempUnits=C&TimeUnits=D"
    },
    {
      "film_name": "Tri-X",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=Tri-X&Developer=&mdc=Search&TempUnits=C&TimeUnits=D"
    }
  ]
}

GET/darkroom/developer/:name/dilutions

Get all available dilutions for a specific developer.

Path Parameters:

Parameter	Type	Description
name	string	Developer name

Example Response:

{
  "developer": "D-76",
  "dilutions": [
    "Stock",
    "1:1",
    "1:3"
  ]
}

GET/darkroom/developer/:name/compatible-films

Get all films compatible with a specific developer.

Path Parameters:

Parameter	Type	Description
name	string	Developer name

Query Parameters:

Parameter	Type	Description
dilution	string	Filter by dilution ratio

Example Response:

{
  "developer": "D-76",
  "dilution": "1:1",
  "films_count": 1,
  "films": [
    {
      "film_name": "HP5 Plus",
      "source_url": "https://www.digitaltruth.com/devchart.php?Film=HP5%20Plus&Developer=&mdc=Search&TempUnits=C&TimeUnits=D",
      "development_options": [
        {
          "dilution": "1:1",
          "iso": "ISO 400",
          "temperature": "20°C",
          "times": {
            "35mm": "7:30",
            "120": "7:30",
            "sheet": "7:30"
          }
        }
      ]
    }
  ]
}

Error Handling

The API uses standard HTTP status codes and returns detailed error messages:

Status Code	Description
400	Bad Request - Invalid parameters
404	Not Found - Resource doesn't exist
500	Internal Server Error

Error Response Format:

{
  "error": "Error type",
  "message": "Human-readable error message",
  "details": "Additional error context (optional)"
}

Data Formats

Type	Format	Example
Development Times	MM:SS	"5:30"
Temperature	XX°C	"20°C"
ISO	ISO XXX	"ISO 400"
Unavailable Times	N/A	"N/A"

Rate Limiting

To ensure API stability, please limit requests to:

60 requests per minute per IP
1000 requests per hour per IP

The data is scraped from digitaltruth.com with a rate limit of 2 requests per second.