Understand an API request

A request has separate parts

An API is a defined way for programs to exchange requests and responses. The URL identifies a resource, the method expresses the operation, headers carry metadata and a body may carry data. GET typically reads; POST commonly submits or creates. Always follow the provider’s specific contract.

For a fictional contact service, a POST body might contain an email and a category. The response might contain a new contact ID. That ID is often what the next step needs; copying the entire response into a text field is a common mapping mistake.

POST /contacts
Content-Type: application/json

{"email": "sam@example.test", "category": "support"}

Success codes are only one check

A 2xx response usually indicates a successful HTTP operation. Still check that the response contains the fields and values your workflow needs. A successful request with the wrong recipient remains a failed business outcome.

A 401 usually points to missing or invalid authentication; 403 indicates refusal of permission; 429 indicates a rate limit. A 5xx response indicates a server-side failure. Exact meanings and safe retry behavior depend on the API documentation.

Keep credentials out of client code

Do not put a private API key into a public page, a lesson note, a screenshot or a shared project. Real integrations should keep credentials in the server’s secret configuration and grant only the access needed.

Before retrying a write, check whether it may already have succeeded. Use the provider’s idempotency mechanism where available. For rate limits, respect Retry-After when provided and use bounded retries rather than a rapid loop.

Practice without contacting a service

Given a fictional 201 response containing {"id": "c_42"}, identify the value you would store for later updates. Then describe how you would handle a 429 and an invalid response body.

This guide and Kyrelio API exercises are educational simulations. They do not send these requests to an external contact service. The APIs & Integrations course page shows which lessons are available and which remain planned.