Power.Dev Optimization Services

<back to all web services

CommonOptimizerYearlyRequest

The following routes are available for this service:
POST/optimizer/yearly
CommonOptimizerYearlyRequest Parameters:
NameParameterData TypeRequiredDescription
MonthbodyintNo
GroupbodyBatteryScenarioKeyGroupYes
KeybodyBatteryScenarioKeyItemYes
ProjectGroupbodyBatteryProjectGroupNo
MonthlyRequestBase Parameters:
NameParameterData TypeRequiredDescription
ProjectIdformGuidNo
NodeAltIdformintNo
IsoformDataProviderNo
UseEnergyformBooleanValueNo
UseAncillaryformBooleanValueNo
UseCapacityTodformboolNo
BaseMarketformPriceMarketTypeNo
CapacityTODsformIEnumerable<BatteryProjectTodItem>Yes
UseRegupformdecimalNo
UseRegdownformdecimalNo
UseSpinningformdecimalNo
UseNonSpinningformdecimalNo
ParaciticLossesOperationformdecimalNo
ParaciticLossesRestingformdecimalNo
HVACLossesformdecimalNo
AcCablingLossesformdecimalNo
TransformatorLossesformdecimalNo
OtherLossesformdecimalNo
RepresentativeYearformintNo
IncrementReferanceYearformintNo
UseFutureDataformintNo
MaxDailyCycleformdecimalNo
MinDailyProfitPerMwformdecimalNo
AncillaryFileIdformintNo
LmpFileIdformintNo
MaxChargingPriceCapformdecimalNo
MaxDischargingPriceCapformdecimalNo
MaxAncillaryPriceCapformdecimalNo
RevenueStackingModeformRevenueStackingModeNo
OptimizationQualityformintNo
EnsureExlusiveformintNo
NodeRefIdformintNo
UseInternalSolverformboolNo
DataProvider Enum:
NameValue
Undefined0
SPP1
ERCOT2
MISO3
CAISO4
PJM5
ISONE6
NYISO7
NW8
SW9
SE10
AESO11
IESO12
CENACE20
NONISO99
EIA100
PNM150
NREL200
NOAA210
ENTSOE1000
EPIAS1010
SELF10000
BooleanValue Enum:
Undefined
Yes
No
Custom
PriceMarketType Enum:
NameValue
Undefined0
Realtime1
DayAhead10
DART101
BatteryProjectTodItem Parameters:
NameParameterData TypeRequiredDescription
MonthformintNo
WeekDayformintNo
HourformintNo
PriceformdecimalNo
IdformstringNo
RevenueStackingMode Enum:
SolveWithoutAncillary
SolveWithAncillary
BatteryScenarioKeyGroup Parameters:
NameParameterData TypeRequiredDescription
KeyIdformintNo
YearformintNo
NodeIdformintNo
ProviderformDataProviderNo
ZoneIdformintNo
PlantTypeformPowerPlantTypeNo
SolarIdformintNo
WindIdformintNo
IsServerlessformboolNo
PowerPlantType Enum:
Undefined
Solar
Wind
Hybrid
BatteryScenarioKeyItem Parameters:
NameParameterData TypeRequiredDescription
ProjectIdformGuidNo
KeyIdformintNo
KeyTypeformBatteryScenarioTypeNo
RecordKeyformstringNo
JobStatusformintNo
StatusformintNo
MinDateformDateTimeNo
MaxDateformDateTimeNo
YearformintNo
YoyStatusformintNo
UsableCapacityformdecimalNo
UsableCapacityFactorformdecimalNo
SolarUsableCapacityformdecimalNo
SolarUsableCapacityFactorformdecimalNo
BaseMarketformPriceMarketTypeNo
BaseCapacityRateformdecimalNo
CapacityRateformdecimalNo
SolarCapacityRateformdecimalNo
WindCapacityRateformdecimalNo
ChargeEfficinecyformdecimalNo
DischargeEfficinecyformdecimalNo
NodeIdformintNo
ProviderformDataProviderNo
ZoneIdformintNo
LmpFileIdformintNo
ProductionFileIdformintNo
LoadFileIdformintNo
CapacityFileIdformintNo
PlantTypeformPowerPlantTypeNo
SolarIdformintNo
WindIdformintNo
AncillaryIncrementFactorformdecimalNo
EnergyIncrementFactorformdecimalNo
CapacityIncrementFactorformdecimalNo
BatteryScenarioType Enum:
Undefined
Optimization
Sum
OptiSum
FullTod
CapacityTod
BatteryProjectGroup Enum:
Undefined
StandAlone
FTM
BTM
YearlyApiStatusResponse Parameters:
NameParameterData TypeRequiredDescription
FailedCountformintNo
MessageformstringYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /optimizer/yearly HTTP/1.1 
Host: dev-optimization.power.dev 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"month":0,"group":{"keyId":0,"year":0,"nodeId":0,"provider":"Undefined","zoneId":0,"plantType":"Undefined","solarId":0,"windId":0,"isServerless":false},"key":{"projectId":"00000000000000000000000000000000","keyId":0,"keyType":"Undefined","recordKey":"String","jobStatus":0,"status":0,"year":0,"yoyStatus":0,"usableCapacity":0,"usableCapacityFactor":0,"solarUsableCapacity":0,"solarUsableCapacityFactor":0,"baseMarket":"Undefined","baseCapacityRate":0,"capacityRate":0,"solarCapacityRate":0,"windCapacityRate":0,"chargeEfficinecy":0,"dischargeEfficinecy":0,"nodeId":0,"provider":"Undefined","zoneId":0,"lmpFileId":0,"productionFileId":0,"loadFileId":0,"capacityFileId":0,"plantType":"Undefined","solarId":0,"windId":0,"ancillaryIncrementFactor":0,"energyIncrementFactor":0,"capacityIncrementFactor":0},"projectGroup":"Undefined","projectId":"00000000000000000000000000000000","nodeAltId":0,"iso":"Undefined","useEnergy":"Undefined","useAncillary":"Undefined","useCapacityTod":false,"baseMarket":"Undefined","useRegup":0,"useRegdown":0,"useSpinning":0,"useNonSpinning":0,"paraciticLossesOperation":0,"paraciticLossesResting":0,"hvacLosses":0,"acCablingLosses":0,"transformatorLosses":0,"otherLosses":0,"representativeYear":0,"incrementReferanceYear":0,"useFutureData":0,"maxDailyCycle":0,"minDailyProfitPerMw":0,"ancillaryFileId":0,"lmpFileId":0,"maxChargingPriceCap":0,"maxDischargingPriceCap":0,"maxAncillaryPriceCap":0,"revenueStackingMode":"SolveWithoutAncillary","optimizationQuality":0,"ensureExlusive":0,"nodeRefId":0,"useInternalSolver":false}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"failedCount":0,"message":"String"}