Skip to content

Operations

This page gives the rules for the daily work of your integration: limits, retries, logs and changes of your servers.

Limits

Each partner ID can send 1000 requests per minute. Above the limit, MEGOGO can return HTTP 429 Too Many Requests.

  • Do not send user/subscriptions for all subscribers on a schedule. Send it only for the subscribers with a change.
  • To increase the limit, ask your MEGOGO manager.

Retries

Send a request again only after a timeout or an HTTP 5xx response.

flowchart TD
    A[Timeout or HTTP 5xx] --> B[user/subscriptions]
    B --> C{Did the first request change the subscription?}
    C -- Yes --> D[Stop. The first request worked]
    C -- No --> E[Wait 1 minute]
    E --> F[Send the request again]
    F --> G{Result}
    G -- Timeout or 5xx, fewer than 6 attempts --> B
    G -- Response --> H[Done]
  1. Get user/subscriptions for the subscriber. Make sure that the first request did not change the subscription.
  2. If the first request did not change the subscription, send it again.
  3. Wait 1 minute between the attempts. Make a maximum of 6 attempts.

WARNING

subscribe and resume are not idempotent. A second successful request can add one more period. Always do step 1 before you send them again.

You can send these requests again without the check: unsubscribe, user/create, user/innerId and user/changeCredentials with the same values. They give the same result.

Logs

We recommend that you keep a log of all requests and responses, with the time in UTC. Give the time of the request and the response to MEGOGO support.

WARNING

Do not write the passwords of the subscribers to the logs. Keep the identifiers and the logins in the logs as your data protection rules require.

Changes of your servers

MEGOGO accepts subscription/{operation}, user/subscriptions and user/changeCredentials only from the IP addresses of your list.

WARNING

Before the IP addresses of your servers change, send the new addresses to supportpartners@megogo.net with your partner ID. Requests from an address that is not in the list get HTTP 401.

Support

Send an e-mail to supportpartners@megogo.net. Write:

  • your partner ID;
  • the identifier of the subscriber and the uid from user/innerId;
  • the request and the response (without the password);
  • the time of the request in UTC.

Guide version 1.0.2, 2026-11-08 · Report a problem on this page