request response35–50 min2 stages8 code languages

Contract slice: Run a safe, punctual airport turnaround

More predictable departures with safer vehicle movement and attributable hand-offs across airport and airline teams.

The real-world moment

A delayed inbound aircraft changes stand while fuel, catering, baggage and inspection teams are already moving. The airport must publish the current approved airside network, re-plan one versioned turnaround, prevent vehicles entering restricted or closed areas, preserve each milestone hand-off, and avoid declaring departure-ready until airline, airport and safety authorities agree.

Operating contract

Make ownership visible before code.

Prove one bounded contract, identity handoff, failure response, and observable first success.

Application state: stateless
Planning calls: 0
Credentials accepted: No
Write authority: None

Capability map

directGIS & Analyticshybrid directInTouch Telematicsstateful directWorkmatestateful directMapsstateless entitlement-dependentCapture & Feedbackhybrid

Normalized operation coverage

An adjacent API is never substituted when the captured corpus has no exact contract.

GIS & Analytics0 exact · reference onlyNo exact normalized REST operation is present in the captured contract corpus for this product. Use its source guides, SDK/widget/distribution surface, and entitlement process without substituting an adjacent API.InTouch Telematics53 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.Workmate13 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.Maps3 exact · normalized contractsExact normalized operations are linked below; account contract and entitlement still require validation.Capture & Feedback0 exact · reference onlyNo exact normalized REST operation is present in the captured contract corpus for this product. Use its source guides, SDK/widget/distribution surface, and entitlement process without substituting an adjacent API.

Airport operational authority

Publish the approved airside network and restricted zones

Airport and airline systems own stands, movement permissions, flight milestones, safety zones, people, equipment and departure decisions; Mappls-derived experiences do not grant aviation or airside authority.

Supporting operation

Airside layer ↔ authority, version, effective window, sensitivity and closure state

GETStill Map Image API/{REST_KEY}/still_imageThis is a supporting operation from the selected product stack, not proof of an exact provider contract for this stage. Resolve the stage through its product source or adapter boundary before live implementation.

Evidence to retain

Record stage 1 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillStand changes after teams accept tasks

Create a new turnaround revision, invalidate incompatible assignments and corridor evidence, and require explicit reacceptance rather than mutating in place.

Versioned spatial operating picture

Create one versioned turnaround plan

Governed enterprise layers publish stands, service roads, closures, restricted zones and emergency access with source, steward, CRS, sensitivity and effective window.

Supporting operation

Turnaround ↔ flight/stand references, milestone graph, version and accountable coordinator

Evidence to retain

Record stage 2 with the application identity, source fingerprint, request or aggregate identity, timestamp, and observable outcome.

Failure drillA vehicle appears outside its approved corridor

Preserve accuracy and network version, alert operations, stop affected automation and require safety review; never infer culpability from a point alone.

Interactive contract lab

Edit once. Generate eight trusted-runtime implementations.

The recipe starts from the normalized GET /alarm/alarmLog/ contract. Execute six deterministic fixture outcomes before an issued account is involved.

Local request composerCode stays local · fixtures are explicit

GETRequest inputs

4 editable · 0 protected

deviceIdqueryNot Mandatory field. This is the ID of the device for which the alarm log need to be fetched. You can pass single device ID or multiple device IDs separated by commaalarmTypequeryNot Mandatory field. This is the type of alarm for which the alarm log need to be fetched. You can pass single alarm type or multiple device IDs separated by comma. Type of alarm to create. Following are the alarm types & their corresponding IDs. IGNITION: 21, OVERSPEED: 22, UNPLUGGED: 23, PANIC: 24, GEOFENCE: 26, STOPPAGE: 27, IDLE: 28, TOWING: 29, GPRS CONNECTIVITY: 126, VEHICLE BATTERY: 129, MILEAGE: 133, GPS CONNECTIVITY: 146, DISTANCE COVERED: 151, INTERNAL BATTERY VOLTAGE:161startTimerequiredqueryMandatory field. This is start timestamp in secondsendTimerequiredqueryMandatory field. This is end timestamp in seconds

Generated in eight languages

Environment-backed credentials

GET

https://intouch.mapmyindia.com/iot/api/alarm/alarmLog/?deviceId=1909%2C2545&alarmType=21%2C26&startTime=1700000000000&endTime=1700000000000

Credential-free sandboxExecute this contract without a provider call

How fixtures work

Generated from your inputs

curl --request GET \
  --url 'https://intouch.mapmyindia.com/iot/api/alarm/alarmLog/?deviceId=1909%2C2545&alarmType=21%2C26&startTime=1700000000000&endTime=1700000000000' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_INTOUCH_TOKEN}"

Credential-safe by constructionSet MAPPLS_INTOUCH_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Reliability contract

Break the journey before customers do.

These controls are required at this operating depth; deeper recipes add durable truth rather than merely more API calls.

Bound inputs and outputsAbortable timeoutRetry only safe readsTyped empty and denied statesSafe request correlationCredential and URL-log redaction

Definition of done

Valid, empty, invalid-input, authentication-denied, rate-limited, timed-out, and unavailable outcomes are distinguishable.

The accepted Mappls or provider identity is retained separately from display text and coordinates.

Credentials remain in the approved runtime and logs retain only safe request evidence.

The exact source contract, auth generation, host, entitlement, quota, and region are reviewed before live traffic.

Continue with canonical evidence

Contracts, tutorials, and journeys stay linked.

Contract set

GETGets The List Of Alarm Config(s)/alarm/alarmLog/GETTo get the list of tasks and their details/tasksGETStill Map Image API/{REST_KEY}/still_imageGETThis API will get all the alarm configurations for a user./alarm

Progressive tutorials

AdvancedQualify an iOS Mappls release2 hr AdvancedQualify React Native native parity100 min

Maintained capstone

Airside Turnaround Desk

Coordinate a revision-safe aircraft turnaround, pause for airside exceptions, preserve four service milestones, and require independent airline, airport, and safety readiness decisions.

Inspect 22 verified tests Download full application

Source-grounded, not authority-granting

This recipe composes source-derived contracts, application architecture, fixtures, and maintained learning evidence. It does not prove package availability, provider payload shape, account entitlement, regional behavior, production compatibility, or release approval.