Recipes/Utilities/stateless
request response35–50 min2 stages8 code languages

Contract slice: Dispatch the right technician, with the right proof

Higher first-time-fix rates and auditable work from dispatch through customer sign-off.

The real-world moment

A utility receives a no-power complaint for a commercial unit. Dispatch must resolve the service point, choose a technician with the correct certification and inventory, survive an offline basement visit, collect readings and imagery, route weak proof to review, and close the job only after the provider and customer records agree.

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
01
Work-order system

Geocode and classify the service location

Owns customer/service asset, SLA, required skills, inventory, commercial outcome, and the authoritative terminal status.

Work order ↔ service asset/location ID, SLA, skill and inventory requirements

GETTo get the list of tasks and their details/tasksThis 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.

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

Technician accepts while another assignment races

Use optimistic aggregate versions and one active assignment invariant; surface conflict instead of last-write-wins.

02
Spatial service context

Assign by skills, shift, inventory, and ETA

Search, asset layers, and mGIS context bind the request to a stable service location, access notes, network assets, and hazards.

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

Offline commands replay after reassignment

Validate actor, task version, and transition preconditions for every queued command; retain rejected evidence.

Edit once. Generate eight trusted-runtime implementations.

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

Local request composerCode stays local · fixtures are explicit
GETRequest inputs
7 editable · 0 protected
Generated in eight languages
Environment-backed credentials
GEThttps://workmate.mapmyindia.com/apis/tasks?startTime=1700000000000&endTime=1700000000000&ownerId=1&assigneeId=1&clientDetails=true&activityDetails=true
Credential-free sandboxExecute this contract without a provider call
How fixtures work
Generated from your inputs
curl --request GET \
  --url 'https://workmate.mapmyindia.com/apis/tasks?startTime=1700000000000&endTime=1700000000000&ownerId=1&assigneeId=1&clientDetails=true&activityDetails=true' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}"

Credential-safe by constructionSet MAPPLS_ACCESS_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.

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.

Contracts, tutorials, and journeys stay linked.

Grid Restoration Desk

Correlate an outage, govern independent switching approval, dispatch an assigned crew, preserve rework, and reconcile restoration from telemetry and customer-impact evidence.

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.